通过命令行工具实现备份和恢复
您可以通过kubectl命令行在集群中部署备份仓库、应用备份、应用恢复的CR资源,实现备份中心的对应功能。本文介绍如何通过命令行工具使用备份中心的备份和恢复功能。
前提条件
已开通HBR服务。对NAS、OSS、本地盘类型存储卷进行备份时,以及在混合云场景中,备份中心需要使用HBR进行文件备份。具体操作,请参见混合云备份HBR。
已创建ACK集群。具体操作,请参见创建Kubernetes托管版集群、创建Kubernetes专有版集群或创建注册集群并接入本地数据中心集群。
重要备份中心功能仅支持v1.18及以上版本的ACK集群使用,如集群版本过低请升级集群。具体操作,请参见升级ACK集群K8s版本。
已开通阿里云对象存储(OSS)服务。具体操作,请参见开通OSS服务。
备份中心不支持Flexvolume插件集群,若您需要使用备份功能,可以通过以下方式迁移至CSI。
若是无存储集群的Flexvolume插件,建议您将存储插件迁移至CSI。具体操作,请参见将无存储集群的Flexvolume迁移至CSI。
其它情况,请加入钉钉用户群(钉钉群号:35532895)咨询。
若您使用ACK托管集群,需要创建cnfs-oss-****名称的Bucket,便于权限最小化管理及存储备份的模板,例如cnfs-oss-backup。
已通过kubectl工具连接Kubernetes集群。具体操作,请参见获取集群KubeConfig并通过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 pvBackup: defaultPvBackup: false storageLocation: <yourBackuplocationName> ttl: 720h0m0s
其余参数无需设置,保持默认配置即可。
参数
说明
csdr.alibabacloud.com/backuplocations
备份所在的备份仓库信息,需与备份仓库的配置一致。
name
立即备份任务的名称。
includedNamespaces
指定命名空间名称。
includedResources
可选,指定集群资源类型。
重要为避免非预期备份结果,includedResources和excludedResources您只需配置一项。均为空时,表示备份所有资源类型。
excludedResources
可选,排除集群资源类型。
重要为避免非预期备份结果,includedResources和excludedResources您只需配置一项。均为空时,表示备份所有资源类型。
matchLabels
可选,指定标签,只备份符合的资源。
defaultPvBackup
是否备份存储卷,开启数据备份。取值:
true:备份应用和存储卷。
false:只备份应用。
storageLocation
备份仓库名称。
说明若您的集群已使用Velero,请加入钉钉用户群(钉钉群号:35532895)咨询。
ttl
备份有效期。
在备份集群中执行以下命令,部署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 pvBackup: defaultPvBackup: true storageLocation: <yourBackuplocationName> ttl: 720h0m0s
其余参数无需设置,保持默认配置即可。
参数
说明
csdr.alibabacloud.com/backuplocations
备份所在的备份仓库信息,需与备份仓库的配置一致。
name
立即备份任务的名称。
schedule
备份周期,使用Cron表达式。
includedNamespaces
指定命名空间名称。
includedResources
可选,指定集群资源类型。
重要为避免非预期备份结果,includedResources和excludedResources您只需配置一项。均为空时,表示备份所有资源类型。
excludedResources
可选,排除集群资源类型。
重要为避免非预期备份结果,includedResources和excludedResources您只需配置一项。均为空时,表示备份所有资源类型。
matchLabels
可选,指定标签,只备份符合的资源。
defaultPvBackup
是否备份存储卷,开启数据备份。取值:
true:备份应用和存储卷。
false:只备份应用。
storageLocation
备份仓库名称。
说明若您的集群已使用Velero,请加入钉钉用户群(钉钉群号:35532895)咨询。
ttl
备份有效期。
在备份集群中执行以下命令,部署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: csdr.alibabacloud.com/backuplocations: >- {"name":"<yourBackuplocationName>","region":"cn-beijing","bucket":"<cnfs-oss-yourBucketName>","prefix":"<subDir>","provider":"alibabacloud"} name: <yourApplicationRestoreName> namespace: csdr spec: backupName: <yourApplicationBackupName> namespaceMapping: <backupNamespace>: <restoreNamespace>
其余参数无需设置,保持默认配置即可。
参数
说明
csdr.alibabacloud.com/backuplocations
备份所在的备份仓库信息,需与备份仓库的配置一致。
name
恢复任务的名称。
backupName
待恢复的备份名称。使用定期备份功能时,需要指定为某个时间点创建的备份名称,例如<yourBackupScheduleName>-20221205225845。
namespaceMapping
可选,重定义命名空间。
<backupNamespace>:创建备份任务时指定的备份集群命名空间。
<restoreNamespace>:根据备份创建的资源在恢复集群的所在命名空间。若不设置,则默认在同名命名空间中恢复。
说明若<restoreNamespace>不存在,将创建新的命名空间。
在恢复集群中执行以下命令,部署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
由预期输出可看到,除恢复任务资源被删除外,删除请求的相关资源也自动被删除。