当您无法通过容器服务控制台操作备份中心或容灾备份需要自动化实现时，您可以通过kubectl命令行在备份集群和恢复集群中部署备份仓库、应用备份、应用恢复的CR资源，以实现不同集群间应用的迁移。
前提条件
已安装备份服务组件并完成对应权限的配置。具体操作，请参见安装migrate-controller备份服务组件并配置权限。
使用场景
因权限问题，无法通过容器服务控制台操作备份中心。
容灾备份流程需要自动化实现。
注意事项
备份及恢复任务不能通过kubectl的
delete命令简单删除。具体操作，请参见下文步骤四：删除集群备份中心的相关资源。关注备份中心组件migrate-controller版本发布情况，并及时升级。具体操作，请参见管理组件。
请勿删除下文示例代码中出现的配置参数，以免备份恢复失败。
步骤一：创建备份仓库
使用以下内容，在备份集群和恢复集群中创建backuplocation.yaml文件。
apiVersion: csdr.alibabacloud.com/v1beta1 kind: BackupLocation metadata: name: <yourBackuplocationName> namespace: csdr spec: backupSyncPeriod: 0s config: network: internal region: cn-beijing objectStorage: bucket: <cnfs-oss-yourBucketName> prefix: <subDir> provider: alibabacloud其余参数无需设置，保持默认配置即可。
参数
是否必选
说明
name
是
备份仓库的名称，须符合K8s命名规则。
network
是
OSS Bucket的网络访问方式。取值：
internal：内网访问模式，所有关联集群与OSS Bucket需处于同一地域。
public：公网访问模式，无地域限制。
region
是
OSS Bucket所在地域。
bucket
是
OSS Bucket名称，需提前创建，且名称需符合以cnfs-oss-****开头的命名规则。
prefix
否
OSS Bucket子目录。设定该参数后，实际备份内容存储在此子目录下。
分别在备份集群和恢复集群中执行以下命令，部署backuplocation对象。
kubectl apply -f backuplocation.yaml分别在备份集群和恢复集群中执行以下命令，查看backuplocation的状态。
kubectl describe backuplocation <yourBackuplocationName> -n csdr预期输出：
... Status: Last Validation Time: 2022-12-08T04:00:22Z Message: success by csdr-controller Phase: Available由预期输出可看到，已创建的备份仓库状态为
Available，说明当前集群具有访问OSS的权限可以直接访问。
步骤二：创建备份任务
创建立即备份任务
使用以下内容，在备份集群中创建applicationbackup.yaml文件。
apiVersion: csdr.alibabacloud.com/v1beta1 kind: ApplicationBackup metadata: annotations: csdr.alibabacloud.com/backuplocations: >- {"name":"<yourBackuplocationName>","region":"cn-beijing","bucket":"<cnfs-oss-yourBucketName>","prefix":"<subDir>","provider":"alibabacloud"}} name: <yourApplicationBackupName> namespace: csdr spec: includedNamespaces: - default includedResources: - statefulset excludedResources: - deployment labelSelector: matchLabels: app: mysql-sts includeClusterResources: false pvBackup: defaultPvBackup: false storageLocation: <yourBackuplocationName> ttl: 720h0m0s其余参数无需设置，保持默认配置即可。
参数
是否必选
说明
csdr.alibabacloud.com/backuplocations
是
备份所在的备份仓库信息，需与备份仓库的配置一致。
name
是
立即备份任务的名称。
includedNamespaces
是
指定命名空间名称。
includedResources
否
指定集群资源类型。
重要为避免非预期备份结果，includedResources和excludedResources您只需配置一项。当两者均为空时，表示备份所有资源类型。
excludedResources
否
排除集群资源类型。
重要为避免非预期备份结果，includedResources和excludedResources您只需配置一项。当两者均为空时，表示备份所有资源类型。
matchLabels
否
指定标签，只备份符合的资源。
includeClusterResources
否
是否备份Cluster级别的资源，例如StorageClass、CRD、Webhook等。
true：备份所有Cluster级别资源。false：仅备份被选择的命名空间中的Namespace级别资源引用的Cluster级别资源。例如，备份Pod时，引用的ServiceAccount授权了某ClusterRole，该ClusterRole将被自动备份；备份CR时，CRD将被自动备份。
说明通过容器服务管理控制台创建的备份任务，默认
IncludeClusterResources字段为false。defaultPvBackup
是否备份存储卷，开启数据备份。取值：
true：备份应用和存储卷。
false：只备份应用。
storageLocation
是
备份仓库名称。
说明若您的集群已使用Velero，请加入钉钉用户群（钉钉群号：35532895）咨询。
ttl
是
备份有效期，即备份任务的数据存储有效期，过期之后数据将无法恢复。格式如720h0m0s，取值范围：24h0m0s~1572864h0m0s。
在备份集群中执行以下命令，部署applicationbackup对象。
kubectl apply -f applicationbackup.yaml在备份集群中执行以下命令，查看立即备份任务的状态。
kubectl describe applicationbackup <yourApplicationBackupName> -n csdr预期输出：
... Status: Completion Timestamp: 2022-12-05T15:02:35Z Expiration: 2023-01-04T15:02:25Z Message: success Phase: Completed当立即备份任务由
Inprogress转为Completed状态，说明立即备份任务创建成功。
创建定时备份计划
使用以下内容，在备份集群中创建backupschedule.yaml文件。
apiVersion: csdr.alibabacloud.com/v1beta1 kind: BackupSchedule metadata: annotations: csdr.alibabacloud.com/backuplocations: >- {"name":"<yourBackuplocationName>","region":"cn-beijing","bucket":"<cnfs-oss-yourBucketName>","prefix":"<subDir>","provider":"alibabacloud"} name: <yourBackupScheduleName> namespace: csdr spec: schedule: 1 4 * * * template: includedNamespaces: - default includedResources: - statefulset excludedResources: - deployment labelSelector: matchLabels: app: mysql-sts includeClusterResources: false pvBackup: defaultPvBackup: true storageLocation: <yourBackuplocationName> ttl: 720h0m0s其余参数无需设置，保持默认配置即可。
参数
是否必选
说明
csdr.alibabacloud.com/backuplocations
是
备份所在的备份仓库信息，需与备份仓库的配置一致。
name
是
定时备份计划的名称。
schedule
是
备份周期，请使用Cron表达式。
includedNamespaces
是
指定命名空间名称。
includedResources
否
指定集群资源类型。
重要为避免非预期备份结果，includedResources和excludedResources您只需配置一项。当两者均为空时，表示备份所有资源类型。
excludedResources
否
排除集群资源类型。
重要为避免非预期备份结果，includedResources和excludedResources您只需配置一项。当两者均为空时，表示备份所有资源类型。
matchLabels
否
指定标签，只备份符合条件的资源。
includeClusterResources
否
是否备份Cluster级别的资源，例如StorageClass、CRD、Webhook等。
true：备份所有Cluster级别资源。false：仅备份被选择的命名空间中的Namespace级别资源引用的Cluster级别资源。例如，备份Pod时，引用的ServiceAccount授权了某ClusterRole，该ClusterRole将被自动备份；备份CR时，CRD将被自动备份。
说明通过容器服务管理控制台创建的备份任务，默认
IncludeClusterResources字段为false。defaultPvBackup
是
是否备份存储卷，开启数据备份。取值：
true：备份应用和存储卷。
false：只备份应用。
storageLocation
是
备份仓库名称。
说明若您的集群已使用Velero，请加入钉钉用户群（钉钉群号：35532895）咨询。
ttl
是
备份有效期，即备份任务的数据存储有效期，过期之后数据将无法恢复。格式如720h0m0s，取值范围：24h0m0s~1572864h0m0s。
在备份集群中执行以下命令，部署backupschedule对象。
kubectl apply -f backupschedule.yaml在备份集群中执行以下命令，查看定时备份计划的状态。
kubectl describe backupschedule <yourBackupScheduleName> -n csdr预期输出：
... Status: Last Backup: 2022-12-07T20:01:11Z Last Processed Time: 2022-12-08T13:05:37Z Phase: Enabled当定时备份计划状态为
Enabled，表明定时备份计划创建成功。在备份集群中执行以下命令，查看定期创建的备份。
kubectl get applicationbackup -n csdr | grep <yourBackupScheduleName>预期输出：
<yourBackupScheduleName>-20221205225845 2d22h <yourBackupScheduleName>-20221206040104 2d17h <yourBackupScheduleName>-20221207040137 41h <yourBackupScheduleName>-20221208040111 17h
步骤三：创建恢复任务
使用以下内容，在恢复集群中创建applicationrestore.yaml文件。
apiVersion: csdr.alibabacloud.com/v1beta1 kind: ApplicationRestore metadata: annotations: csdr.alibabacloud.com/backuplocations: >- {"name":"<yourBackuplocationName>","region":"cn-beijing","bucket":"<cnfs-oss-yourBucketName>","prefix":"<subDir>","provider":"alibabacloud"} name: <yourApplicationRestoreName> namespace: csdr spec: appRestoreOnly: false preserveNodePorts: true includedNamespaces: - default includedResources: - statefulset excludedResources: - secret convertedarg: - convertToStorageClassType: alicloud-disk-topology-alltype namespace: nas persistentVolumeClaim: pvc-nas - convertToStorageClassType: alicloud-disk-topology-alltype namespace: oss persistentVolumeClaim: pvc-oss backupName: <yourApplicationBackupName> namespaceMapping: <backupNamespace>: <restoreNamespace>其余参数无需设置，保持默认配置即可。
参数
是否必选
说明
csdr.alibabacloud.com/backuplocations
是
备份所在的备份仓库信息，需与备份仓库的配置一致。
name
是
恢复任务的名称。
appRestoreOnly
否
对于备份了存储卷的备份，是否仅恢复应用，不恢复存储声明、存储卷及其对应的数据，取值：
true：仅恢复应用。如果您需要更改备份应用的数据源，可以先手动创建存储声明、存储卷，然后再创建恢复任务并将该参数设置为true。
false：恢复应用以及相关的存储数据，默认为false。
preserveNodePorts
否
是否保持应用的NodePort端口。当备份集群与恢复集群相同时，默认为false，将随机修改端口值，避免与已有的同类应用冲突。否则设置为true。
includedNamespaces
是
指定恢复的命名空间名称。设置为空时，表示恢复所有已备份的命名空间。
includedResources
否
指定待恢复的集群资源类型。
重要为避免非预期备份结果，includedResources和excludedResources您只需配置一项。均为空时，表示恢复所有已备份的资源类型。
excludedResources
否
排除待恢复的集群资源类型。
重要为避免非预期备份结果，includedResources和excludedResources您只需配置一项。均为空时，表示恢复所有已备份的资源类型。
backupName
是
待恢复的备份名称。使用定期备份功能时，需要指定为某个时间点创建的备份名称，例如<yourBackupScheduleName>-20221205225845。
namespaceMapping
否
重定义命名空间。取值：
<backupNamespace>：创建备份任务时指定的备份集群命名空间。
<restoreNamespace>：根据备份创建的资源在恢复集群的所在命名空间。若不设置，则默认在同名命名空间中恢复。
说明若<restoreNamespace>不存在，将创建新的命名空间。
convertedarg
否
转换存储类列表。备份中的FileSystem数据类型的存储卷（OSS、NAS、CPFS、本地存储等）的存储声明，在当前集群中恢复为目标存储类，实现例如NAS存储至云盘存储的转换。
convertToStorageClassType：目标存储类，需要在当前集群已存在。当前版本仅支持选择云盘或NAS类型的存储类。
namespace：存储声明所在的命名空间。
persistentVolumeClaim：存储声明名称。
您可以通过
kubectl -ncsdr describe <backup-name>查询备份的存储声明信息，在输出的status.resourceList.dataResource.pvcBackupInfo列表中dataType字段为数据类型，分为FileSystem与Snapshot，nameSpace与pvcName分别为存储声明所在的命名空间与存储声明名称。重要对于ReadWriteMany类型的存储卷，暂不支持恢复为云盘类型；对于ReadOnlyMany类型的存储卷，恢复为云盘类型时，需由业务保证不会被多个节点上的副本同时挂载，造成强制拔盘。
在恢复集群中执行以下命令，部署applicationrestore对象。
kubectl apply -f applicationrestore.yaml在恢复集群中执行以下命令，查看恢复任务的状态。
kubectl describe applicationrestore <yourApplicationRestoreName> -n csdr预期输出：
... Status: Completion Timestamp: 2022-12-05T15:52:19Z Phase: Completed Start Timestamp: 2022-12-05T15:52:09Z当恢复任务由
Inprogress转为Completed状态，说明恢复任务创建成功。
步骤四：删除集群备份中心的相关资源
由于您已创建的备份仓库可能正在被其他集群使用，所以备份中心不支持备份仓库BackupLocation资源的删除。
删除定时备份计划
执行以下命令，删除定时备份计划BackupSchedule资源，停止定时备份。
kubectl delete backupschedule <yourBackupSchedule> - ncsdr删除备份任务或恢复任务
使用以下内容，在待删除任务的集群中创建deleterequest.yaml文件。
apiVersion: csdr.alibabacloud.com/v1beta1 kind: DeleteRequest metadata: name: <objectName-dbr> namespace: csdr spec: deleteObjectName: <objectName> deleteObjectType: "Backup"其余参数无需设置，保持默认配置即可。
参数
是否必选
说明
name
是
删除请求的名称。
删除备份任务时：待删除的备份任务ApplicationBackup的名称+“-dbr”。
删除恢复任务时：待删除的恢复任务ApplicationRestore的名称+“-dbr”。
deleteObjectName
是
待删除的资源名称。
deleteObjectType
是
待删除的资源类型。取值：
"Backup"：删除备份任务ApplicationBackup及配套资源。
"Restore"：删除恢复任务ApplicationRestore及配套资源。
说明删除备份任务不会影响已同步到集群中的副本。
删除恢复任务不会影响已恢复的内容。
在待删除任务的集群中执行以下命令，部署deleterequest删除请求。
kubectl apply -f deleterequest.yaml使用以下命令，查看资源状态。
查看删除的备份任务
执行以下命令，查看删除备份任务的状态。
kubectl get applicationbackup <yourApplicationBackupName> -n csdr预期输出：
Error from server (NotFound): applicationbackups.csdr.alibabacloud.com "yourApplicationBackupName" not found由预期输出可看到，备份任务资源已被删除。
执行以下命令，查看删除请求资源的状态。
kubectl get deleterequest <yourApplicationBackupName-dbr> -n csdr预期输出：
Error from server (NotFound): deleterequests.csdr.alibabacloud.com "yourApplicationBackupName-dbr" not found由预期输出可看到，除备份任务资源被删除外，删除请求的相关资源也自动被删除。
查看删除的恢复任务
执行以下命令，查看删除备份任务的状态。
kubectl get applicationrestore <yourApplicationRestoreName> -n csdr预期输出：
Error from server (NotFound): applicationrestores.csdr.alibabacloud.com "yourApplicationRestoreName" not found由预期输出可看到，恢复任务资源已被删除。
执行以下命令，查看删除请求资源的状态。
kubectl get deleterequest <yourApplicationRestoreName-dbr> -n csdr预期输出：
Error from server (NotFound): deleterequests.csdr.alibabacloud.com "yourApplicationRestoreName-dbr" not found由预期输出可看到，除恢复任务资源被删除外，删除请求的相关资源也自动被删除。
相关文档
如果需要通过控制台实现集群应用的备份迁移，请根据实际需求参见如下文档：
如果需要实现跨存储插件、跨版本集群间的应用迁移，请参见通过备份中心实现低版本Kubernetes集群应用迁移。