4.4. 备份和恢复

流程

1. 输入以下命令来检索 backupStorageLocations CR：

   $ oc get backupStorageLocations

   输出示例

   NAME              PHASE       LAST VALIDATED   AGE   DEFAULT
   velero-sample-1   Available   11s              31m

2. 创建一个 Backup CR，如下例所示：

   apiVersion: velero.io/v1
   kind: Backup
   metadata:
     name: <backup>
     labels:
       velero.io/storage-location: default
     namespace: openshift-adp
   spec:
     hooks: {}
     includedNamespaces:
     - <namespace> 1
     includedResources: [] 2
     excludedResources: [] 3
     storageLocation: <velero-sample-1> 4
     ttl: 720h0m0s
     labelSelector: 5
       matchLabels:
         app=<label_1>
         app=<label_2>
         app=<label_3>
     orLabelSelectors: 6
     - matchLabels:
         app=<label_1>
         app=<label_2>
         app=<label_3>

   1

   指定要备份的命名空间数组。

   2

   可选：指定一个要包含在备份中的资源的数组。资源可以是缩写方式（例如，'po' 代表 'pods'）或完全限定的方式。如果未指定，则会包含所有资源。

   3

   可选：指定要从备份中排除的资源数组。资源可以是缩写方式（例如，'po' 代表 'pods'）或完全限定的方式。

   4

   指定 backupStorageLocations CR 的名称。

   5

   具有所有指定标签的备份资源的 {key,value} 对映射。

   6

   具有一个或多个指定标签的备份资源的 {key,value} 对映射。

3. 验证 Backup CR 的状态是否为 Completed ：

   $ oc get backup -n openshift-adp <backup> -o jsonpath='{.status.phase}'

流程

1. 通过创建一个 .yaml 文件来配置 Restic secret，如下所示：

   apiVersion: v1
   kind: Secret
   metadata:
     name: <secret_name>
     namespace: openshift-adp
   type: Opaque
   stringData:
     RESTIC_PASSWORD: <secure_restic_password>

   注意

   默认情况下，Operator 会查找名为 dm-credential 的 secret。如果您使用其他名称，您需要使用 dpa.spec.features.dataMover.credentialName 通过 Data Protection Application (DPA) CR 指定名称。

2. 创建类似以下示例的 DPA CR。默认插件包括 CSI。

   数据保护应用程序 (DPA) CR 示例

   apiVersion: oadp.openshift.io/v1alpha1
   kind: DataProtectionApplication
   metadata:
     name: velero-sample
     namespace: openshift-adp
   spec:
     features:
       dataMover:
         enable: true
         credentialName: <secret_name> 1
     backupLocations:
       - velero:
           config:
             profile: default
             region: us-east-1
           credential:
             key: cloud
             name: cloud-credentials
           default: true
           objectStorage:
             bucket: <bucket_name>
             prefix: <bucket_prefix>
           provider: aws
     configuration:
       restic:
         enable: <true_or_false>
       velero:
         defaultPlugins:
           - openshift
           - aws
           - csi

   1

   添加上一步中的 Restic secret 名称。如果没有这样做，则使用默认 secret 名称 dm-credential。

   OADP Operator 安装两个自定义资源定义 (CRD)、VolumeSnapshotBackup 和 VolumeSnapshotRestore。

   VolumeSnapshotBackup CRD 示例

   apiVersion: datamover.oadp.openshift.io/v1alpha1
   kind: VolumeSnapshotBackup
   metadata:
     name: <vsb_name>
     namespace: <namespace_name> 1
   spec:
     volumeSnapshotContent:
       name: <snapcontent_name>
     protectedNamespace: <adp_namespace>
     resticSecretRef:
       name: <restic_secret_name>

   1

   指定卷快照所在的命名空间。

   VolumeSnapshotRestore CRD 示例

   apiVersion: datamover.oadp.openshift.io/v1alpha1
   kind: VolumeSnapshotRestore
   metadata:
     name: <vsr_name>
     namespace: <namespace_name> 1
   spec:
     protectedNamespace: <protected_ns> 2
     resticSecretRef:
       name: <restic_secret_name>
     volumeSnapshotMoverBackupRef:
       sourcePVCData:
         name: <source_pvc_name>
         size: <source_pvc_size>
       resticrepository: <your_restic_repo>
       volumeSnapshotClassName: <vsclass_name>

   1

   指定卷快照所在的命名空间。

   2

   指定安装 Operator 的命名空间。默认值为 openshift-adp。

3. 您可以执行以下步骤备份卷快照：

   1. 创建备份 CR：

      apiVersion: velero.io/v1
      kind: Backup
      metadata:
        name: <backup_name>
        namespace: <protected_ns> 1
      spec:
        includedNamespaces:
        - <app_ns>
        storageLocation: velero-sample-1

      1

      指定安装 Operator 的命名空间。默认命名空间是 openshift-adp。

   2. 等待 10 分钟，并输入以下命令来检查 VolumeSnapshotBackup CR 状态是否为 Completed ：

      $ oc get vsb -n <app_ns>

      $ oc get vsb <vsb_name> -n <app_ns> -o jsonpath="{.status.phase}"

      在对象存储中创建快照是在 DPA 中配置。

      注意

      如果 VolumeSnapshotBackup CR 的状态变为 Failed，请参阅 Velero 日志进行故障排除。

4. 您可以执行以下步骤来恢复卷快照：

   1. 删除由 Velero CSI 插件创建的 application 命名空间和 volumeSnapshotContent。

   2. 创建 Restore CR，并将 restorePV 设置为 true。

      Restore CR 示例

      apiVersion: velero.io/v1
      kind: Restore
      metadata:
        name: <restore_name>
        namespace: <protected_ns>
      spec:
        backupName: <previous_backup_name>
        restorePVs: true

   3. 等待 10 分钟，并通过输入以下命令来检查 VolumeSnapshotRestore CR 状态是否为 Completed ：

      $ oc get vsr -n <app_ns>

      $ oc get vsr <vsr_name> -n <app_ns> -o jsonpath="{.status.phase}"

   4. 检查您的应用程序数据和资源是否已恢复。

      注意

      如果 VolumeSnapshotRestore CR 的状态变成 'Failed'，请参阅 Velero 日志进行故障排除。

流程

1. 检索 backupStorageLocations CR：

   $ oc get backupStorageLocations

   输出示例

   NAME              PHASE       LAST VALIDATED   AGE   DEFAULT
   velero-sample-1   Available   11s              31m

2. 创建一个 Schedule CR，如下例所示：

   $ cat << EOF | oc apply -f -
   apiVersion: velero.io/v1
   kind: Schedule
   metadata:
     name: <schedule>
     namespace: openshift-adp
   spec:
     schedule: 0 7 * * * 1
     template:
       hooks: {}
       includedNamespaces:
       - <namespace> 2
       storageLocation: <velero-sample-1> 3
       defaultVolumesToRestic: true 4
       ttl: 720h0m0s
   EOF

   1

   调度备份的 cron 表达式，例如 0 7 * * * 代表在每天 7:00 执行备份。

   2

   要备份的命名空间数组。

   3

   backupStorageLocations CR 的名称。

   4

   可选：如果使用 Restic 备份卷，请添加 defaultVolumesToRestic: true 键-值对。

3. 在调度的备份运行后验证 Schedule CR 的状态是否为 Completed ：

   $ oc get schedule -n openshift-adp <schedule> -o jsonpath='{.status.phase}'

流程

1. 创建一个 Restore CR，如下例所示：

   apiVersion: velero.io/v1
   kind: Restore
   metadata:
     name: <restore>
     namespace: openshift-adp
   spec:
     backupName: <backup> 1
     includedResources: [] 2
     excludedResources:
     - nodes
     - events
     - events.events.k8s.io
     - backups.velero.io
     - restores.velero.io
     - resticrepositories.velero.io
     restorePVs: true 3

   1

   备份 CR 的名称。

   2

   可选：指定要包含在恢复过程中的资源数组。资源可以是缩写方式（例如，po 代表 pods）或完全限定的方式。如果未指定，则会包含所有资源。

   3

   可选：restorePV 参数可以被设置为 false，以便在配置了 VolumeSnaphshotLocation 时从 VolumeSnapshot Container Storage Interface (CSI) 快照中关闭 PersistentVolume。

2. 输入以下命令验证 Restore CR 的状态是否为 Completed ：

   $ oc get restore -n openshift-adp <restore> -o jsonpath='{.status.phase}'

3. 输入以下命令验证备份资源是否已恢复：

   $ oc get all -n <namespace> 1

   1

   备份的命名空间。

4. 如果您使用 Restic 恢复 DeploymentConfig 对象，或使用 post-restore hook，请输入以下命令运行 dc-restic-post-restore.sh cleanup 脚本：

   $ bash dc-restic-post-restore.sh <restore-name>

   注意

   在恢复过程中，OADP Velero 插件会缩减 DeploymentConfig 对象，并将 pod 恢复为独立 pod，以防止集群在恢复时立即删除恢复的 DeploymentConfig pod，并允许 Restic 和 post-restore hook 在恢复的 pod 上完成其操作。清理脚本会删除这些断开连接的 pod，并将任何 DeploymentConfig 对象扩展至适当的副本数。

   例 4.1. dc-restic-post-restore.sh cleanup 脚本

   #!/bin/bash
   set -e
   
   # if sha256sum exists, use it to check the integrity of the file
   if command -v sha256sum >/dev/null 2>&1; then
     CHECKSUM_CMD="sha256sum"
   else
     CHECKSUM_CMD="shasum -a 256"
   fi
   
   label_name () {
       if [ "${#1}" -le "63" ]; then
   	echo $1
   	return
       fi
       sha=$(echo -n $1|$CHECKSUM_CMD)
       echo "${1:0:57}${sha:0:6}"
   }
   
   OADP_NAMESPACE=${OADP_NAMESPACE:=openshift-adp}
   
   if [[ $# -ne 1 ]]; then
       echo "usage: ${BASH_SOURCE} restore-name"
       exit 1
   fi
   
   echo using OADP Namespace $OADP_NAMESPACE
   echo restore: $1
   
   label=$(label_name $1)
   echo label: $label
   
   echo Deleting disconnected restore pods
   oc delete pods -l oadp.openshift.io/disconnected-from-dc=$label
   
   for dc in $(oc get dc --all-namespaces -l oadp.openshift.io/replicas-modified=$label -o jsonpath='{range .items[*]}{.metadata.namespace}{","}{.metadata.name}{","}{.metadata.annotations.oadp\.openshift\.io/original-replicas}{","}{.metadata.annotations.oadp\.openshift\.io/original-paused}{"\n"}')
   do
       IFS=',' read -ra dc_arr <<< "$dc"
       if [ ${#dc_arr[0]} -gt 0 ]; then
   	echo Found deployment ${dc_arr[0]}/${dc_arr[1]}, setting replicas: ${dc_arr[2]}, paused: ${dc_arr[3]}
   	cat <<EOF | oc patch dc  -n ${dc_arr[0]} ${dc_arr[1]} --patch-file /dev/stdin
   spec:
     replicas: ${dc_arr[2]}
     paused: ${dc_arr[3]}
   EOF
       fi
   done