备份和恢复

流程

1. 创建一个 OBC 清单文件来请求 NooBaa MCG 存储桶，如下例所示：

   OBC 示例

   apiVersion: objectbucket.io/v1alpha1
   kind: ObjectBucketClaim
   metadata:
     name: test-obc 1
     namespace: openshift-adp
   spec:
     storageClassName: openshift-storage.noobaa.io
     generateBucketName: test-backup-bucket 2

   1

   对象存储桶声明的名称。

   2

   bucket 的名称。

2. 运行以下命令来创建 OBC：

   $ oc create -f <obc_file_name> 1

   1

   指定对象存储桶声明清单的文件名。

3. 当您创建 OBC 时，ODF 会创建一个 secret 和配置映射，其名称与对象存储桶声明相同。secret 具有存储桶凭证，配置映射 有访问存储桶的信息。要从生成的配置映射中获取存储桶名称和存储桶主机，请运行以下命令：

   $ oc extract --to=- cm/test-obc 1

   1

   test-obc 是 OBC 的名称。

   输出示例

   # BUCKET_NAME
   backup-c20...41fd
   # BUCKET_PORT
   443
   # BUCKET_REGION
   
   # BUCKET_SUBREGION
   
   # BUCKET_HOST
   s3.openshift-storage.svc

4. 要从生成的 secret 获取存储桶凭证，请运行以下命令：

   $ oc extract --to=- secret/test-obc

   输出示例

   # AWS_ACCESS_KEY_ID
   ebYR....xLNMc
   # AWS_SECRET_ACCESS_KEY
   YXf...+NaCkdyC3QPym

5. 运行以下命令，从 openshift-storage 命名空间中的 s3 路由获取 S3 端点的公共 URL：

   $ oc get route s3 -n openshift-storage

6. 使用对象存储桶凭证创建一个 cloud-credentials 文件，如下所示：

   [default]
   aws_access_key_id=<AWS_ACCESS_KEY_ID>
   aws_secret_access_key=<AWS_SECRET_ACCESS_KEY>

7. 使用 cloud-credentials 文件内容创建 cloud-credentials secret，如下所示：

   $ oc create secret generic \
     cloud-credentials \
     -n openshift-adp \
     --from-file cloud=cloud-credentials

8. 配置 Data Protection Application (DPA)，如下例所示：

   DPA 示例

   apiVersion: oadp.openshift.io/v1alpha1
   kind: DataProtectionApplication
   metadata:
     name: oadp-backup
     namespace: openshift-adp
   spec:
     configuration:
       nodeAgent:
         enable: true
         uploaderType: kopia
       velero:
         defaultPlugins:
           - aws
           - openshift
           - csi
         defaultSnapshotMoveData: true 1
     backupLocations:
       - velero:
           config:
             profile: "default"
             region: noobaa
             s3Url: https://s3.openshift-storage.svc 2
             s3ForcePathStyle: "true"
             insecureSkipTLSVerify: "true"
           provider: aws
           default: true
           credential:
             key: cloud
             name:  cloud-credentials
           objectStorage:
             bucket: <bucket_name> 3
             prefix: oadp

   1

   设置为 true 来使用 OADP Data Mover 将 Container Storage Interface (CSI)快照移动到远程对象存储。

   2

   这是 ODF 存储的 S3 URL。

   3

   指定存储桶名称。

9. 运行以下命令来创建 DPA：

   $ oc apply -f <dpa_filename>

10. 运行以下命令，验证 DPA 是否已成功创建。在示例输出中，您可以看到 status 对象将 type 字段设置为 Reconciled。这意味着 DPA 已被成功创建。

    $ oc get dpa -o yaml

    输出示例

    apiVersion: v1
    items:
    - apiVersion: oadp.openshift.io/v1alpha1
      kind: DataProtectionApplication
      metadata:
        namespace: openshift-adp
        #...#
      spec:
        backupLocations:
        - velero:
            config:
              #...#
      status:
        conditions:
        - lastTransitionTime: "20....9:54:02Z"
          message: Reconcile complete
          reason: Complete
          status: "True"
          type: Reconciled
    kind: List
    metadata:
      resourceVersion: ""

11. 运行以下命令，验证备份存储位置(BSL)是否可用：

    $ oc get backupstoragelocations.velero.io -n openshift-adp

    输出示例

    NAME           PHASE       LAST VALIDATED   AGE   DEFAULT
    dpa-sample-1   Available   3s               15s   true

12. 配置备份 CR，如下例所示：

    备份 CR 示例

    apiVersion: velero.io/v1
    kind: Backup
    metadata:
      name: test-backup
      namespace: openshift-adp
    spec:
      includedNamespaces:
      - <application_namespace> 1

    1

    指定要备份的应用程序的命名空间。

13. 运行以下命令来创建备份 CR：

    $ oc apply -f <backup_cr_filename>

流程

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

   恢复 CR 示例

   apiVersion: velero.io/v1
   kind: Restore
   metadata:
     name: test-restore 1
     namespace: openshift-adp
   spec:
     backupName: <backup_name> 2
     restorePVs: true
     namespaceMapping:
       <application_namespace>: test-restore-application 3

   1

   恢复 CR 的名称。

   2

   指定备份的名称。

   3

   namespaceMapping 将源应用程序命名空间映射到目标应用程序命名空间。指定您备份的应用程序命名空间。test-restore-application 是您要恢复备份的目标命名空间。

2. 运行以下命令来应用恢复 CR：

   $ oc apply -f <restore_cr_filename>

验证

1. 运行以下命令验证恢复是否处于 Completed 阶段：

   $ oc describe restores.velero.io <restore_name> -n openshift-adp

2. 运行以下命令，进入恢复的命名空间 test-restore-application ：

   $ oc project test-restore-application

3. 运行以下命令，验证恢复的资源，如持久性卷声明(pvc)、服务(svc)、部署、secret 和配置映射：

   $ oc get pvc,svc,deployment,secret,configmap

   输出示例

   NAME                          STATUS   VOLUME
   persistentvolumeclaim/mysql   Bound    pvc-9b3583db-...-14b86
   
   NAME               TYPE        CLUSTER-IP     EXTERNAL-IP   PORT(S)    AGE
   service/mysql      ClusterIP   172....157     <none>        3306/TCP   2m56s
   service/todolist   ClusterIP   172.....15     <none>        8000/TCP   2m56s
   
   NAME                    READY   UP-TO-DATE   AVAILABLE   AGE
   deployment.apps/mysql   0/1     1            0           2m55s
   
   NAME                                         TYPE                      DATA   AGE
   secret/builder-dockercfg-6bfmd               kubernetes.io/dockercfg   1      2m57s
   secret/default-dockercfg-hz9kz               kubernetes.io/dockercfg   1      2m57s
   secret/deployer-dockercfg-86cvd              kubernetes.io/dockercfg   1      2m57s
   secret/mysql-persistent-sa-dockercfg-rgp9b   kubernetes.io/dockercfg   1      2m57s
   
   NAME                                 DATA   AGE
   configmap/kube-root-ca.crt           1      2m57s
   configmap/openshift-service-ca.crt   1      2m57s

流程

1. 创建 OBC 清单以请求 NooBaa 存储桶，如下例所示：

   Example ObjectBucketClaim CR

   apiVersion: objectbucket.io/v1alpha1
   kind: ObjectBucketClaim
   metadata:
     name: test-obc 1
     namespace: openshift-adp
   spec:
     storageClassName: openshift-storage.noobaa.io
     generateBucketName: test-backup-bucket 2

   1

   指定对象存储桶声明的名称。

   2

   指定存储桶的名称。

2. 运行以下命令来创建 OBC：

   $ oc create -f <obc_file_name>

3. 创建 OBC 时，ODF 会创建一个与对象存储桶声明相同的 secret 和 ConfigMap。secret 对象包含存储桶凭证，ConfigMap 对象包含用于访问存储桶的信息。要从生成的配置映射中获取存储桶名称和存储桶主机，请运行以下命令：

   $ oc extract --to=- cm/test-obc 1

   1

   OBC 的名称为 test-obc。

   输出示例

   # BUCKET_NAME
   backup-c20...41fd
   # BUCKET_PORT
   443
   # BUCKET_REGION
   
   # BUCKET_SUBREGION
   
   # BUCKET_HOST
   s3.openshift-storage.svc

4. 要从 secret 对象获取存储桶凭证，请运行以下命令：

   $ oc extract --to=- secret/test-obc

   输出示例

   # AWS_ACCESS_KEY_ID
   ebYR....xLNMc
   # AWS_SECRET_ACCESS_KEY
   YXf...+NaCkdyC3QPym

5. 使用以下示例配置创建带有对象存储桶凭证的 cloud-credentials 文件：

   [default]
   aws_access_key_id=<AWS_ACCESS_KEY_ID>
   aws_secret_access_key=<AWS_SECRET_ACCESS_KEY>

6. 运行以下命令，使用 cloud-credentials 文件内容创建 cloud-credentials secret：

   $ oc create secret generic \
     cloud-credentials \
     -n openshift-adp \
     --from-file cloud=cloud-credentials

7. 运行以下命令，从 openshift-service-ca.crt 配置映射中提取服务 CA 证书。确保您以 Base64 格式编码证书，并记录下一步中使用的值。

   $ oc get cm/openshift-service-ca.crt \
     -o jsonpath='{.data.service-ca\.crt}' | base64 -w0; echo

   输出示例

   LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0...
   ....gpwOHMwaG9CRmk5a3....FLS0tLS0K

8. 使用存储桶名称和 CA 证书配置 DataProtectionApplication CR 清单文件，如下例所示：

   DataProtectionApplication CR 示例

   apiVersion: oadp.openshift.io/v1alpha1
   kind: DataProtectionApplication
   metadata:
     name: oadp-backup
     namespace: openshift-adp
   spec:
     configuration:
       nodeAgent:
         enable: true
         uploaderType: kopia
       velero:
         defaultPlugins:
           - aws
           - openshift
           - csi
         defaultSnapshotMoveData: true
     backupLocations:
       - velero:
           config:
             profile: "default"
             region: noobaa
             s3Url: https://s3.openshift-storage.svc
             s3ForcePathStyle: "true"
             insecureSkipTLSVerify: "false" 1
           provider: aws
           default: true
           credential:
             key: cloud
             name:  cloud-credentials
           objectStorage:
             bucket: <bucket_name> 2
             prefix: oadp
             caCert: <ca_cert> 3

   1

   insecureSkipTLSVerify 标志可以设置为 true 或 false。如果设置为 "true"，则禁用 SSL/TLS 安全性。如果设置为 false，则启用 SSL/TLS 安全性。

   2

   指定上一步中提取的存储桶的名称。

   3

   复制并粘贴上一步中的 Base64 编码证书。

9. 运行以下命令来创建 DataProtectionApplication CR：

   $ oc apply -f <dpa_filename>

10. 运行以下命令验证 DataProtectionApplication CR 是否已成功创建：

    $ oc get dpa -o yaml

    输出示例

    apiVersion: v1
    items:
    - apiVersion: oadp.openshift.io/v1alpha1
      kind: DataProtectionApplication
      metadata:
        namespace: openshift-adp
        #...#
      spec:
        backupLocations:
        - velero:
            config:
              #...#
      status:
        conditions:
        - lastTransitionTime: "20....9:54:02Z"
          message: Reconcile complete
          reason: Complete
          status: "True"
          type: Reconciled
    kind: List
    metadata:
      resourceVersion: ""

11. 运行以下命令，验证备份存储位置(BSL)是否可用：

    $ oc get backupstoragelocations.velero.io -n openshift-adp

    输出示例

    NAME           PHASE       LAST VALIDATED   AGE   DEFAULT
    dpa-sample-1   Available   3s               15s   true

12. 使用以下示例配置 Backup CR：

    Backup CR 示例

    apiVersion: velero.io/v1
    kind: Backup
    metadata:
      name: test-backup
      namespace: openshift-adp
    spec:
      includedNamespaces:
      - <application_namespace> 1

    1

    指定要备份的应用程序的命名空间。

13. 运行以下命令来创建 Backup CR：

    $ oc apply -f <backup_cr_filename>

流程

1. 将 DataProtectionApplication CR 配置为使用 legacy-aws Velero 插件，如下例所示：

   DataProtectionApplication CR 示例

   apiVersion: oadp.openshift.io/v1alpha1
   kind: DataProtectionApplication
   metadata:
     name: oadp-backup
     namespace: openshift-adp
   spec:
     configuration:
       nodeAgent:
         enable: true
         uploaderType: kopia
       velero:
         defaultPlugins:
           - legacy-aws 1
           - openshift
           - csi
         defaultSnapshotMoveData: true
     backupLocations:
       - velero:
           config:
             profile: "default"
             region: noobaa
             s3Url: https://s3.openshift-storage.svc
             s3ForcePathStyle: "true"
             insecureSkipTLSVerify: "true"
           provider: aws
           default: true
           credential:
             key: cloud
             name:  cloud-credentials
           objectStorage:
             bucket: <bucket_name> 2
             prefix: oadp

   1

   使用 legacy-aws 插件。

   2

   指定存储桶名称。

2. 运行以下命令来创建 DataProtectionApplication CR：

   $ oc apply -f <dpa_filename>

3. 运行以下命令，验证 DataProtectionApplication CR 是否已成功创建。在示例输出中，您可以看到 status 对象将 type 字段设置为 Reconciled，status 字段设置为 "True "。该状态表示 DataProtectionApplication CR 已被成功创建。

   $ oc get dpa -o yaml

   输出示例

   apiVersion: v1
   items:
   - apiVersion: oadp.openshift.io/v1alpha1
     kind: DataProtectionApplication
     metadata:
       namespace: openshift-adp
       #...#
     spec:
       backupLocations:
       - velero:
           config:
             #...#
     status:
       conditions:
       - lastTransitionTime: "20....9:54:02Z"
         message: Reconcile complete
         reason: Complete
         status: "True"
         type: Reconciled
   kind: List
   metadata:
     resourceVersion: ""

4. 运行以下命令，验证备份存储位置(BSL)是否可用：

   $ oc get backupstoragelocations.velero.io -n openshift-adp

   输出示例

   NAME           PHASE       LAST VALIDATED   AGE   DEFAULT
   dpa-sample-1   Available   3s               15s   true

5. 配置 Backup CR，如下例所示：

   备份 CR 示例

   apiVersion: velero.io/v1
   kind: Backup
   metadata:
     name: test-backup
     namespace: openshift-adp
   spec:
     includedNamespaces:
     - <application_namespace> 1

   1

   指定要备份的应用程序的命名空间。

6. 运行以下命令来创建 Backup CR：

   $ oc apply -f <backup_cr_filename>

流程

1. 设置 BUCKET 变量：

   $ BUCKET=<your_bucket>

2. 设置 REGION 变量：

   $ REGION=<your_region>

3. 创建 AWS S3 存储桶：

   $ aws s3api create-bucket \
       --bucket $BUCKET \
       --region $REGION \
       --create-bucket-configuration LocationConstraint=$REGION 1

   1

   us-east-1 不支持 LocationConstraint。如果您的区域是 us-east-1，忽略 --create-bucket-configuration LocationConstraint=$REGION。

4. 创建一个 IAM 用户：

   $ aws iam create-user --user-name velero 1

   1

   如果要使用 Velero 备份具有多个 S3 存储桶的集群，请为每个集群创建一个唯一用户名。

5. 创建 velero-policy.json 文件：

   $ cat > velero-policy.json <<EOF
   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Effect": "Allow",
               "Action": [
                   "ec2:DescribeVolumes",
                   "ec2:DescribeSnapshots",
                   "ec2:CreateTags",
                   "ec2:CreateVolume",
                   "ec2:CreateSnapshot",
                   "ec2:DeleteSnapshot"
               ],
               "Resource": "*"
           },
           {
               "Effect": "Allow",
               "Action": [
                   "s3:GetObject",
                   "s3:DeleteObject",
                   "s3:PutObject",
                   "s3:AbortMultipartUpload",
                   "s3:ListMultipartUploadParts"
               ],
               "Resource": [
                   "arn:aws:s3:::${BUCKET}/*"
               ]
           },
           {
               "Effect": "Allow",
               "Action": [
                   "s3:ListBucket",
                   "s3:GetBucketLocation",
                   "s3:ListBucketMultipartUploads"
               ],
               "Resource": [
                   "arn:aws:s3:::${BUCKET}"
               ]
           }
       ]
   }
   EOF

6. 附加策略，为 velero 用户提供所需的最低权限：

   $ aws iam put-user-policy \
     --user-name velero \
     --policy-name velero \
     --policy-document file://velero-policy.json

7. 为 velero 用户创建访问密钥：

   $ aws iam create-access-key --user-name velero

   输出示例

   {
     "AccessKey": {
           "UserName": "velero",
           "Status": "Active",
           "CreateDate": "2017-07-31T22:24:41.576Z",
           "SecretAccessKey": <AWS_SECRET_ACCESS_KEY>,
           "AccessKeyId": <AWS_ACCESS_KEY_ID>
     }
   }

8. 创建 credentials-velero 文件：

   $ cat << EOF > ./credentials-velero
   [default]
   aws_access_key_id=<AWS_ACCESS_KEY_ID>
   aws_secret_access_key=<AWS_SECRET_ACCESS_KEY>
   EOF

   在安装数据保护应用程序前，您可以使用 credentials-velero 文件为 AWS 创建 Secret 对象。

流程

1. 点 Operators → Installed Operators 并选择 OADP Operator。
2. 在 Provided APIs 下，点 DataProtectionApplication 框中的 Create 实例。

3. 点 YAML View 并更新 DataProtectionApplication 清单的参数：

   apiVersion: oadp.openshift.io/v1alpha1
   kind: DataProtectionApplication
   metadata:
     name: <dpa_sample>
     namespace: openshift-adp 1
   spec:
     configuration:
       velero:
         defaultPlugins:
           - openshift 2
           - aws
         resourceTimeout: 10m 3
       nodeAgent: 4
         enable: true 5
         uploaderType: kopia 6
         podConfig:
           nodeSelector: <node_selector> 7
     backupLocations:
       - name: default
         velero:
           provider: aws
           default: true
           objectStorage:
             bucket: <bucket_name> 8
             prefix: <prefix> 9
           config:
             region: <region>
             profile: "default"
             s3ForcePathStyle: "true" 10
             s3Url: <s3_url> 11
           credential:
             key: cloud
             name: cloud-credentials 12
     snapshotLocations: 13
       - name: default
         velero:
           provider: aws
           config:
             region: <region> 14
             profile: "default"
           credential:
             key: cloud
             name: cloud-credentials 15

   1

   OADP 的默认命名空间是 openshift-adp。命名空间是一个变量，可配置。

   2

   openshift 插件是必需的。

   3

   指定在超时发生前等待多个 Velero 资源的分钟，如 Velero CRD 可用、volumeSnapshot 删除和备份存储库可用。默认值为 10m。

   4

   将管理请求路由到服务器的管理代理。

   5

   如果要启用 nodeAgent 并执行文件系统备份，则将此值设置为 true。

   6

   输入 kopia 或 restic 作为您的上传者。您不能在安装后更改选择。对于 Built-in DataMover，您必须使用 Kopia。nodeAgent 部署守护进程集，这意味着 nodeAgent pod 在每个工作节点上运行。您可以通过在 Backup CR 中添加 spec.defaultVolumesToFsBackup: true 来配置文件系统备份。

   7

   指定 Kopia 或 Restic 可用的节点。默认情况下，Kopia 或 Restic 在所有节点上运行。

   8

   指定存储桶作为备份存储位置。如果存储桶不是 Velero 备份的专用存储桶，您必须指定一个前缀。

   9

   如果存储桶用于多个目的，请为 Velero 备份指定一个前缀，如 velero。

   10

   指定是否为 S3 对象强制路径风格 URL (Boolean)。AWS S3 不需要。只适用于 S3 兼容存储。

   11

   指定您用于存储备份的对象存储的 URL。AWS S3 不需要。只适用于 S3 兼容存储。

   12

   指定您创建的 Secret 对象的名称。如果没有指定这个值，则使用默认值 cloud-credentials。如果您指定了自定义名称，则使用自定义名称进行备份位置。

   13

   指定快照位置，除非您使用 CSI 快照或文件系统备份 (FSB)备份 PV。

   14

   快照位置必须与 PV 位于同一区域。

   15

   指定您创建的 Secret 对象的名称。如果没有指定这个值，则使用默认值 cloud-credentials。如果指定了自定义名称，则自定义名称用于快照位置。如果您的备份和快照位置使用不同的凭证，您可以在 credentials-velero 文件中创建单独的配置集。

4. 点 Create。

验证

1. 运行以下命令，查看 OpenShift API for Data Protection (OADP) 资源来验证安装：

   $ oc get all -n openshift-adp

   输出示例

   NAME                                                     READY   STATUS    RESTARTS   AGE
   pod/oadp-operator-controller-manager-67d9494d47-6l8z8    2/2     Running   0          2m8s
   pod/node-agent-9cq4q                                     1/1     Running   0          94s
   pod/node-agent-m4lts                                     1/1     Running   0          94s
   pod/node-agent-pv4kr                                     1/1     Running   0          95s
   pod/velero-588db7f655-n842v                              1/1     Running   0          95s
   
   NAME                                                       TYPE        CLUSTER-IP       EXTERNAL-IP   PORT(S)    AGE
   service/oadp-operator-controller-manager-metrics-service   ClusterIP   172.30.70.140    <none>        8443/TCP   2m8s
   service/openshift-adp-velero-metrics-svc                   ClusterIP   172.30.10.0      <none>        8085/TCP   8h
   
   NAME                        DESIRED   CURRENT   READY   UP-TO-DATE   AVAILABLE   NODE SELECTOR   AGE
   daemonset.apps/node-agent    3         3         3       3            3           <none>          96s
   
   NAME                                                READY   UP-TO-DATE   AVAILABLE   AGE
   deployment.apps/oadp-operator-controller-manager    1/1     1            1           2m9s
   deployment.apps/velero                              1/1     1            1           96s
   
   NAME                                                           DESIRED   CURRENT   READY   AGE
   replicaset.apps/oadp-operator-controller-manager-67d9494d47    1         1         1       2m9s
   replicaset.apps/velero-588db7f655                              1         1         1       96s

2. 运行以下命令，验证 DataProtectionApplication (DPA) 是否已协调：

   $ oc get dpa dpa-sample -n openshift-adp -o jsonpath='{.status}'

   输出示例

   {"conditions":[{"lastTransitionTime":"2023-10-27T01:23:57Z","message":"Reconcile complete","reason":"Complete","status":"True","type":"Reconciled"}]}

3. 验证 type 被设置为 Reconciled。

4. 运行以下命令，验证备份存储位置并确认 PHASE 为 Available ：

   $ oc get backupstoragelocations.velero.io -n openshift-adp

   输出示例

   NAME           PHASE       LAST VALIDATED   AGE     DEFAULT
   dpa-sample-1   Available   1s               3d16h   true

流程

1. 使用多个 BSL 配置 DPA。请参见以下示例。

   DPA 示例

   apiVersion: oadp.openshift.io/v1alpha1
   kind: DataProtectionApplication
   #...
   backupLocations:
     - name: aws 1
       velero:
         provider: aws
         default: true 2
         objectStorage:
           bucket: <bucket_name> 3
           prefix: <prefix> 4
         config:
           region: <region_name> 5
           profile: "default"
         credential:
           key: cloud
           name: cloud-credentials 6
     - name: odf 7
       velero:
         provider: aws
         default: false
         objectStorage:
           bucket: <bucket_name>
           prefix: <prefix>
         config:
           profile: "default"
           region: <region_name>
           s3Url: <url> 8
           insecureSkipTLSVerify: "true"
           s3ForcePathStyle: "true"
         credential:
           key: cloud
           name: <custom_secret_name_odf> 9
   #...

   1

   为第一个 BSL 指定名称。

   2

   此参数表示此 BSL 是默认的 BSL。如果没有在 Backup CR 中设置 BSL，则会使用默认的 BSL。您只能将一个 BSL 设置为默认值。

   3

   指定存储桶名称。

   4

   为 Velero 备份指定一个前缀，如 velero。

   5

   指定存储桶的 AWS 区域。

   6

   指定您创建的默认 Secret 对象的名称。

   7

   为第二个 BSL 指定名称。

   8

   指定 S3 端点的 URL。

   9

   为 Secret 指定正确的名称；例如，custom_secret_name_odf。如果没有指定 Secret 名称，则使用默认名称。

2. 指定要在备份 CR 中使用的 BSL。请参见以下示例。

   备份 CR 示例

   apiVersion: velero.io/v1
   kind: Backup
   # ...
   spec:
     includedNamespaces:
     - <namespace> 1
     storageLocation: <backup_storage_location> 2
     defaultVolumesToFsBackup: true

   1

   指定要备份的命名空间。

   2

   指定存储位置。

流程

1. 运行以下命令来安装 IBM Cloud Object Storage (COS)插件：

   $ ibmcloud plugin install cos -f

2. 运行以下命令来设置存储桶名称：

   $ BUCKET=<bucket_name>

3. 运行以下命令来设置存储桶区域：

   $ REGION=<bucket_region> 1

   1

   指定存储桶区域，如 eu-gb。

4. 运行以下命令来创建资源组：

   $ ibmcloud resource group-create <resource_group_name>

5. 运行以下命令来设置目标资源组：

   $ ibmcloud target -g <resource_group_name>

6. 运行以下命令验证目标资源组是否已正确设置：

   $ ibmcloud target

   输出示例

   API endpoint:     https://cloud.ibm.com
   Region:
   User:             test-user
   Account:          Test Account (fb6......e95) <-> 2...122
   Resource group:   Default

   在示例输出中，资源组设置为 Default。

7. 运行以下命令来设置资源组名称：

   $ RESOURCE_GROUP=<resource_group> 1

   1

   指定资源组名称，例如 "default "。

8. 运行以下命令来创建 IBM Cloud service-instance 资源：

   $ ibmcloud resource service-instance-create \
   <service_instance_name> \1
   <service_name> \2
   <service_plan> \3
   <region_name> 4

   1

   为 service-instance 资源指定一个名称。

   2

   指定服务名称。或者，您可以指定服务 ID。

   3

   指定 IBM Cloud 帐户的服务计划。

   4

   指定区域名称。

   示例命令

   $ ibmcloud resource service-instance-create test-service-instance cloud-object-storage \ 1
   standard \
   global \
   -d premium-global-deployment 2

   1

   服务名称是 cloud-object-storage。

   2

   -d 标志指定部署名称。

9. 运行以下命令来提取服务实例 ID：

   $ SERVICE_INSTANCE_ID=$(ibmcloud resource service-instance test-service-instance --output json | jq -r '.[0].id')

10. 运行以下命令来创建 COS 存储桶：

    $ ibmcloud cos bucket-create \//
    --bucket $BUCKET \//
    --ibm-service-instance-id $SERVICE_INSTANCE_ID \//
    --region $REGION

    $BUCKET、$SERVICE_INSTANCE_ID 和 $REGION 等变量将被您之前设置的值替代。

11. 运行以下命令来创建 HMAC 凭据。

    $ ibmcloud resource service-key-create test-key Writer --instance-name test-service-instance --parameters {\"HMAC\":true}

12. 从 HMAC 凭证中提取访问密钥 ID 和 secret 访问密钥，并将它们保存到 credentials-velero 文件中。您可以使用 credentials-velero 文件为备份存储位置创建 secret。运行以下命令:

    $ cat > credentials-velero << __EOF__
    [default]
    aws_access_key_id=$(ibmcloud resource service-key test-key -o json  | jq -r '.[0].credentials.cos_hmac_keys.access_key_id')
    aws_secret_access_key=$(ibmcloud resource service-key test-key -o json  | jq -r '.[0].credentials.cos_hmac_keys.secret_access_key')
    __EOF__

流程

1. 为您的云供应商为快照位置创建一个 credentials-velero 文件。

2. 使用默认名称为快照位置创建 Secret ：

   $ oc create secret generic cloud-credentials -n openshift-adp --from-file cloud=credentials-velero

3. 为您的对象存储创建一个用于备份位置的 credentials-velero 文件。

4. 使用自定义名称为备份位置创建 Secret ：

   $ oc create secret generic <custom_secret> -n openshift-adp --from-file cloud=credentials-velero

5. 将带有自定义名称的 Secret 添加到 DataProtectionApplication CR 中，如下例所示：

   apiVersion: oadp.openshift.io/v1alpha1
   kind: DataProtectionApplication
   metadata:
     name: <dpa_sample>
     namespace: openshift-adp
   spec:
   ...
     backupLocations:
       - velero:
           provider: <provider>
           default: true
           credential:
             key: cloud
             name: <custom_secret> 1
           objectStorage:
             bucket: <bucket_name>
             prefix: <prefix>

   1

   具有自定义名称的备份位置 Secret。

流程

1. 点 Operators → Installed Operators 并选择 OADP Operator。
2. 在 Provided APIs 下，点 DataProtectionApplication 框中的 Create 实例。

3. 点 YAML View 并更新 DataProtectionApplication 清单的参数：

   apiVersion: oadp.openshift.io/v1alpha1
   kind: DataProtectionApplication
   metadata:
     namespace: openshift-adp
     name: <dpa_name>
   spec:
     configuration:
       velero:
         defaultPlugins:
         - openshift
         - aws
         - csi
     backupLocations:
       - velero:
           provider: aws 1
           default: true
           objectStorage:
             bucket: <bucket_name> 2
             prefix: velero
           config:
             insecureSkipTLSVerify: 'true'
             profile: default
             region: <region_name> 3
             s3ForcePathStyle: 'true'
             s3Url: <s3_url> 4
           credential:
             key: cloud
             name: cloud-credentials 5

   1

   当使用 IBM Cloud 作为备份存储位置时，供应商是 aws。

   2

   指定 IBM Cloud Object Storage (COS)存储桶名称。

   3

   指定 COS 区域名称，如 eu-gb。

   4

   指定 COS 存储桶的 S3 URL。例如： http://s3.eu-gb.cloud-object-storage.appdomain.cloud。在这里，eu-gb 是区域名称。根据您的存储桶区域替换区域名称。

   5

   使用 access key 和 secret access key 从 HMAC 凭证定义您创建的 secret 名称。

4. 点 Create。

验证

1. 运行以下命令，查看 OpenShift API for Data Protection (OADP) 资源来验证安装：

   $ oc get all -n openshift-adp

   输出示例

   NAME                                                     READY   STATUS    RESTARTS   AGE
   pod/oadp-operator-controller-manager-67d9494d47-6l8z8    2/2     Running   0          2m8s
   pod/node-agent-9cq4q                                     1/1     Running   0          94s
   pod/node-agent-m4lts                                     1/1     Running   0          94s
   pod/node-agent-pv4kr                                     1/1     Running   0          95s
   pod/velero-588db7f655-n842v                              1/1     Running   0          95s
   
   NAME                                                       TYPE        CLUSTER-IP       EXTERNAL-IP   PORT(S)    AGE
   service/oadp-operator-controller-manager-metrics-service   ClusterIP   172.30.70.140    <none>        8443/TCP   2m8s
   service/openshift-adp-velero-metrics-svc                   ClusterIP   172.30.10.0      <none>        8085/TCP   8h
   
   NAME                        DESIRED   CURRENT   READY   UP-TO-DATE   AVAILABLE   NODE SELECTOR   AGE
   daemonset.apps/node-agent    3         3         3       3            3           <none>          96s
   
   NAME                                                READY   UP-TO-DATE   AVAILABLE   AGE
   deployment.apps/oadp-operator-controller-manager    1/1     1            1           2m9s
   deployment.apps/velero                              1/1     1            1           96s
   
   NAME                                                           DESIRED   CURRENT   READY   AGE
   replicaset.apps/oadp-operator-controller-manager-67d9494d47    1         1         1       2m9s
   replicaset.apps/velero-588db7f655                              1         1         1       96s

2. 运行以下命令，验证 DataProtectionApplication (DPA) 是否已协调：

   $ oc get dpa dpa-sample -n openshift-adp -o jsonpath='{.status}'

   输出示例

   {"conditions":[{"lastTransitionTime":"2023-10-27T01:23:57Z","message":"Reconcile complete","reason":"Complete","status":"True","type":"Reconciled"}]}

3. 验证 type 被设置为 Reconciled。

4. 运行以下命令，验证备份存储位置并确认 PHASE 为 Available ：

   $ oc get backupstoragelocations.velero.io -n openshift-adp

   输出示例

   NAME           PHASE       LAST VALIDATED   AGE     DEFAULT
   dpa-sample-1   Available   1s               3d16h   true

流程

1. 使用多个 BSL 配置 DPA。请参见以下示例。

   DPA 示例

   apiVersion: oadp.openshift.io/v1alpha1
   kind: DataProtectionApplication
   #...
   backupLocations:
     - name: aws 1
       velero:
         provider: aws
         default: true 2
         objectStorage:
           bucket: <bucket_name> 3
           prefix: <prefix> 4
         config:
           region: <region_name> 5
           profile: "default"
         credential:
           key: cloud
           name: cloud-credentials 6
     - name: odf 7
       velero:
         provider: aws
         default: false
         objectStorage:
           bucket: <bucket_name>
           prefix: <prefix>
         config:
           profile: "default"
           region: <region_name>
           s3Url: <url> 8
           insecureSkipTLSVerify: "true"
           s3ForcePathStyle: "true"
         credential:
           key: cloud
           name: <custom_secret_name_odf> 9
   #...

   1

   为第一个 BSL 指定名称。

   2

   此参数表示此 BSL 是默认的 BSL。如果没有在 Backup CR 中设置 BSL，则会使用默认的 BSL。您只能将一个 BSL 设置为默认值。

   3

   指定存储桶名称。

   4

   为 Velero 备份指定一个前缀，如 velero。

   5

   指定存储桶的 AWS 区域。

   6

   指定您创建的默认 Secret 对象的名称。

   7

   为第二个 BSL 指定名称。

   8

   指定 S3 端点的 URL。

   9

   为 Secret 指定正确的名称；例如，custom_secret_name_odf。如果没有指定 Secret 名称，则使用默认名称。

2. 指定要在备份 CR 中使用的 BSL。请参见以下示例。

   备份 CR 示例

   apiVersion: velero.io/v1
   kind: Backup
   # ...
   spec:
     includedNamespaces:
     - <namespace> 1
     storageLocation: <backup_storage_location> 2
     defaultVolumesToFsBackup: true

   1

   指定要备份的命名空间。

   2

   指定存储位置。

流程

1. 要禁用 nodeAgent，请将 enable 标志设置为 false。请参见以下示例：

   DataProtectionApplication CR 示例

   # ...
   configuration:
     nodeAgent:
       enable: false  1
       uploaderType: kopia
   # ...

   1

   禁用节点代理。

2. 要启用 nodeAgent，将 enable 标志设置为 true。请参见以下示例：

   DataProtectionApplication CR 示例

   # ...
   configuration:
     nodeAgent:
       enable: true  1
       uploaderType: kopia
   # ...

   1

   启用节点代理。

流程

1. 点 Operators → Installed Operators 并选择 OADP Operator。
2. 在 Provided APIs 下，点 DataProtectionApplication 框中的 Create 实例。

3. 点 YAML View 并更新 DataProtectionApplication 清单的参数：

   apiVersion: oadp.openshift.io/v1alpha1
   kind: DataProtectionApplication
   metadata:
     name: <dpa_sample>
     namespace: openshift-adp 1
   spec:
     configuration:
       velero:
         defaultPlugins:
           - azure
           - openshift 2
         resourceTimeout: 10m 3
       nodeAgent: 4
         enable: true 5
         uploaderType: kopia 6
         podConfig:
           nodeSelector: <node_selector> 7
     backupLocations:
       - velero:
           config:
             resourceGroup: <azure_resource_group> 8
             storageAccount: <azure_storage_account_id> 9
             subscriptionId: <azure_subscription_id> 10
             storageAccountKeyEnvVar: AZURE_STORAGE_ACCOUNT_ACCESS_KEY
           credential:
             key: cloud
             name: cloud-credentials-azure  11
           provider: azure
           default: true
           objectStorage:
             bucket: <bucket_name> 12
             prefix: <prefix> 13
     snapshotLocations: 14
       - velero:
           config:
             resourceGroup: <azure_resource_group>
             subscriptionId: <azure_subscription_id>
             incremental: "true"
           name: default
           provider: azure
           credential:
             key: cloud
             name: cloud-credentials-azure 15

   1

   OADP 的默认命名空间是 openshift-adp。命名空间是一个变量，可配置。

   2

   openshift 插件是必需的。

   3

   指定在超时发生前等待多个 Velero 资源的分钟，如 Velero CRD 可用、volumeSnapshot 删除和备份存储库可用。默认值为 10m。

   4

   将管理请求路由到服务器的管理代理。

   5

   如果要启用 nodeAgent 并执行文件系统备份，则将此值设置为 true。

   6

   输入 kopia 或 restic 作为您的上传者。您不能在安装后更改选择。对于 Built-in DataMover，您必须使用 Kopia。nodeAgent 部署守护进程集，这意味着 nodeAgent pod 在每个工作节点上运行。您可以通过在 Backup CR 中添加 spec.defaultVolumesToFsBackup: true 来配置文件系统备份。

   7

   指定 Kopia 或 Restic 可用的节点。默认情况下，Kopia 或 Restic 在所有节点上运行。

   8

   指定 Azure 资源组。

   9

   指定 Azure 存储帐户 ID。

   10

   指定 Azure 订阅 ID。

   11

   如果没有指定这个值，则使用默认值 cloud-credentials-azure。如果您指定了自定义名称，则使用自定义名称进行备份位置。

   12

   指定存储桶作为备份存储位置。如果存储桶不是 Velero 备份的专用存储桶，您必须指定一个前缀。

   13

   如果存储桶用于多个目的，请为 Velero 备份指定一个前缀，如 velero。

   14

   如果您使用 CSI 快照或 Restic 备份 PV，则不需要指定快照位置。

   15

   指定您创建的 Secret 对象的名称。如果没有指定这个值，则使用默认值 cloud-credentials-azure。如果您指定了自定义名称，则使用自定义名称进行备份位置。

4. 点 Create。

验证

1. 运行以下命令，查看 OpenShift API for Data Protection (OADP) 资源来验证安装：

   $ oc get all -n openshift-adp

   输出示例

   NAME                                                     READY   STATUS    RESTARTS   AGE
   pod/oadp-operator-controller-manager-67d9494d47-6l8z8    2/2     Running   0          2m8s
   pod/node-agent-9cq4q                                     1/1     Running   0          94s
   pod/node-agent-m4lts                                     1/1     Running   0          94s
   pod/node-agent-pv4kr                                     1/1     Running   0          95s
   pod/velero-588db7f655-n842v                              1/1     Running   0          95s
   
   NAME                                                       TYPE        CLUSTER-IP       EXTERNAL-IP   PORT(S)    AGE
   service/oadp-operator-controller-manager-metrics-service   ClusterIP   172.30.70.140    <none>        8443/TCP   2m8s
   service/openshift-adp-velero-metrics-svc                   ClusterIP   172.30.10.0      <none>        8085/TCP   8h
   
   NAME                        DESIRED   CURRENT   READY   UP-TO-DATE   AVAILABLE   NODE SELECTOR   AGE
   daemonset.apps/node-agent    3         3         3       3            3           <none>          96s
   
   NAME                                                READY   UP-TO-DATE   AVAILABLE   AGE
   deployment.apps/oadp-operator-controller-manager    1/1     1            1           2m9s
   deployment.apps/velero                              1/1     1            1           96s
   
   NAME                                                           DESIRED   CURRENT   READY   AGE
   replicaset.apps/oadp-operator-controller-manager-67d9494d47    1         1         1       2m9s
   replicaset.apps/velero-588db7f655                              1         1         1       96s

2. 运行以下命令，验证 DataProtectionApplication (DPA) 是否已协调：

   $ oc get dpa dpa-sample -n openshift-adp -o jsonpath='{.status}'

   输出示例

   {"conditions":[{"lastTransitionTime":"2023-10-27T01:23:57Z","message":"Reconcile complete","reason":"Complete","status":"True","type":"Reconciled"}]}

3. 验证 type 被设置为 Reconciled。

4. 运行以下命令，验证备份存储位置并确认 PHASE 为 Available ：

   $ oc get backupstoragelocations.velero.io -n openshift-adp

   输出示例

   NAME           PHASE       LAST VALIDATED   AGE     DEFAULT
   dpa-sample-1   Available   1s               3d16h   true

流程

1. 登录到 GCP:

   $ gcloud auth login

2. 设置 BUCKET 变量：

   $ BUCKET=<bucket> 1

   1

   指定存储桶名称。

3. 创建存储桶：

   $ gsutil mb gs://$BUCKET/

4. 将 PROJECT_ID 变量设置为您的活跃项目：

   $ PROJECT_ID=$(gcloud config get-value project)

5. 创建服务帐户：

   $ gcloud iam service-accounts create velero \
       --display-name "Velero service account"

6. 列出服务帐户：

   $ gcloud iam service-accounts list

7. 设置 SERVICE_ACCOUNT_EMAIL 变量，使其与 email 值匹配：

   $ SERVICE_ACCOUNT_EMAIL=$(gcloud iam service-accounts list \
       --filter="displayName:Velero service account" \
       --format 'value(email)')

8. 附加策略，为 velero 用户提供所需的最低权限：

   $ ROLE_PERMISSIONS=(
       compute.disks.get
       compute.disks.create
       compute.disks.createSnapshot
       compute.snapshots.get
       compute.snapshots.create
       compute.snapshots.useReadOnly
       compute.snapshots.delete
       compute.zones.get
       storage.objects.create
       storage.objects.delete
       storage.objects.get
       storage.objects.list
       iam.serviceAccounts.signBlob
   )

9. 创建 velero.server 自定义角色：

   $ gcloud iam roles create velero.server \
       --project $PROJECT_ID \
       --title "Velero Server" \
       --permissions "$(IFS=","; echo "${ROLE_PERMISSIONS[*]}")"

10. 为项目添加 IAM 策略绑定：

    $ gcloud projects add-iam-policy-binding $PROJECT_ID \
        --member serviceAccount:$SERVICE_ACCOUNT_EMAIL \
        --role projects/$PROJECT_ID/roles/velero.server

11. 更新 IAM 服务帐户：

    $ gsutil iam ch serviceAccount:$SERVICE_ACCOUNT_EMAIL:objectAdmin gs://${BUCKET}

12. 将 IAM 服务帐户的密钥保存到当前目录中的 credentials-velero 文件中：

    $ gcloud iam service-accounts keys create credentials-velero \
        --iam-account $SERVICE_ACCOUNT_EMAIL

    在安装 Data Protection Application 前，您可以使用 credentials-velero 文件为 GCP 创建 Secret 对象。

流程

1. 运行以下命令，创建一个 oadp-credrequest 目录：

   $ mkdir -p oadp-credrequest

2. 创建 CredentialsRequest.yaml 文件，如下所示：

   echo 'apiVersion: cloudcredential.openshift.io/v1
   kind: CredentialsRequest
   metadata:
     name: oadp-operator-credentials
     namespace: openshift-cloud-credential-operator
   spec:
     providerSpec:
       apiVersion: cloudcredential.openshift.io/v1
       kind: GCPProviderSpec
       permissions:
       - compute.disks.get
       - compute.disks.create
       - compute.disks.createSnapshot
       - compute.snapshots.get
       - compute.snapshots.create
       - compute.snapshots.useReadOnly
       - compute.snapshots.delete
       - compute.zones.get
       - storage.objects.create
       - storage.objects.delete
       - storage.objects.get
       - storage.objects.list
       - iam.serviceAccounts.signBlob
       skipServiceCheck: true
     secretRef:
       name: cloud-credentials-gcp
       namespace: <OPERATOR_INSTALL_NS>
     serviceAccountNames:
     - velero
   ' > oadp-credrequest/credrequest.yaml

3. 运行以下命令，使用 ccoctl 实用程序处理 oadp-credrequest 目录中的 CredentialsRequest 对象：

   $ ccoctl gcp create-service-accounts \
       --name=<name> \
       --project=<gcp_project_id> \
       --credentials-requests-dir=oadp-credrequest \
       --workload-identity-pool=<pool_id> \
       --workload-identity-provider=<provider_id>

   manifests/openshift-adp-cloud-credentials-gcp-credentials.yaml 文件现在可用于以下步骤。

4. 运行以下命令来创建命名空间：

   $ oc create namespace <OPERATOR_INSTALL_NS>

5. 运行以下命令，将凭证应用到命名空间：

   $ oc apply -f manifests/openshift-adp-cloud-credentials-gcp-credentials.yaml

流程

1. 点 Operators → Installed Operators 并选择 OADP Operator。
2. 在 Provided APIs 下，点 DataProtectionApplication 框中的 Create 实例。

3. 点 YAML View 并更新 DataProtectionApplication 清单的参数：

   apiVersion: oadp.openshift.io/v1alpha1
   kind: DataProtectionApplication
   metadata:
     name: <dpa_sample>
     namespace: <OPERATOR_INSTALL_NS> 1
   spec:
     configuration:
       velero:
         defaultPlugins:
           - gcp
           - openshift 2
         resourceTimeout: 10m 3
       nodeAgent: 4
         enable: true 5
         uploaderType: kopia 6
         podConfig:
           nodeSelector: <node_selector> 7
     backupLocations:
       - velero:
           provider: gcp
           default: true
           credential:
             key: cloud 8
             name: cloud-credentials-gcp 9
           objectStorage:
             bucket: <bucket_name> 10
             prefix: <prefix> 11
     snapshotLocations: 12
       - velero:
           provider: gcp
           default: true
           config:
             project: <project>
             snapshotLocation: us-west1 13
           credential:
             key: cloud
             name: cloud-credentials-gcp 14
     backupImages: true 15

   1

   OADP 的默认命名空间是 openshift-adp。命名空间是一个变量，可配置。

   2

   openshift 插件是必需的。

   3

   指定在超时发生前等待多个 Velero 资源的分钟，如 Velero CRD 可用、volumeSnapshot 删除和备份存储库可用。默认值为 10m。

   4

   将管理请求路由到服务器的管理代理。

   5

   如果要启用 nodeAgent 并执行文件系统备份，则将此值设置为 true。

   6

   输入 kopia 或 restic 作为您的上传者。您不能在安装后更改选择。对于 Built-in DataMover，您必须使用 Kopia。nodeAgent 部署守护进程集，这意味着 nodeAgent pod 在每个工作节点上运行。您可以通过在 Backup CR 中添加 spec.defaultVolumesToFsBackup: true 来配置文件系统备份。

   7

   指定 Kopia 或 Restic 可用的节点。默认情况下，Kopia 或 Restic 在所有节点上运行。

   8

   包含凭证的 secret 密钥。对于 Google 工作负载身份联邦云身份验证，请使用 service_account.json。

   9

   包含凭证的 secret 名称。如果没有指定这个值，则使用默认值 cloud-credentials-gcp。

   10

   指定存储桶作为备份存储位置。如果存储桶不是 Velero 备份的专用存储桶，您必须指定一个前缀。

   11

   如果存储桶用于多个目的，请为 Velero 备份指定一个前缀，如 velero。

   12

   指定快照位置，除非您使用 CSI 快照或 Restic 备份 PV。

   13

   快照位置必须与 PV 位于同一区域。

   14

   指定您创建的 Secret 对象的名称。如果没有指定这个值，则使用默认值 cloud-credentials-gcp。如果您指定了自定义名称，则使用自定义名称进行备份位置。

   15

   Google 工作负载身份联邦支持内部镜像备份。如果您不想使用镜像备份，请将此字段设置为 false。

4. 点 Create。

验证

1. 运行以下命令，查看 OpenShift API for Data Protection (OADP) 资源来验证安装：

   $ oc get all -n openshift-adp

   输出示例

   NAME                                                     READY   STATUS    RESTARTS   AGE
   pod/oadp-operator-controller-manager-67d9494d47-6l8z8    2/2     Running   0          2m8s
   pod/node-agent-9cq4q                                     1/1     Running   0          94s
   pod/node-agent-m4lts                                     1/1     Running   0          94s
   pod/node-agent-pv4kr                                     1/1     Running   0          95s
   pod/velero-588db7f655-n842v                              1/1     Running   0          95s
   
   NAME                                                       TYPE        CLUSTER-IP       EXTERNAL-IP   PORT(S)    AGE
   service/oadp-operator-controller-manager-metrics-service   ClusterIP   172.30.70.140    <none>        8443/TCP   2m8s
   service/openshift-adp-velero-metrics-svc                   ClusterIP   172.30.10.0      <none>        8085/TCP   8h
   
   NAME                        DESIRED   CURRENT   READY   UP-TO-DATE   AVAILABLE   NODE SELECTOR   AGE
   daemonset.apps/node-agent    3         3         3       3            3           <none>          96s
   
   NAME                                                READY   UP-TO-DATE   AVAILABLE   AGE
   deployment.apps/oadp-operator-controller-manager    1/1     1            1           2m9s
   deployment.apps/velero                              1/1     1            1           96s
   
   NAME                                                           DESIRED   CURRENT   READY   AGE
   replicaset.apps/oadp-operator-controller-manager-67d9494d47    1         1         1       2m9s
   replicaset.apps/velero-588db7f655                              1         1         1       96s

2. 运行以下命令，验证 DataProtectionApplication (DPA) 是否已协调：

   $ oc get dpa dpa-sample -n openshift-adp -o jsonpath='{.status}'

   输出示例

   {"conditions":[{"lastTransitionTime":"2023-10-27T01:23:57Z","message":"Reconcile complete","reason":"Complete","status":"True","type":"Reconciled"}]}

3. 验证 type 被设置为 Reconciled。

4. 运行以下命令，验证备份存储位置并确认 PHASE 为 Available ：

   $ oc get backupstoragelocations.velero.io -n openshift-adp

   输出示例

   NAME           PHASE       LAST VALIDATED   AGE     DEFAULT
   dpa-sample-1   Available   1s               3d16h   true

流程

1. 通过对 NooBaa 自定义资源运行 describe 命令，获取 S3 端点、AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY。

2. 创建 credentials-velero 文件：

   $ cat << EOF > ./credentials-velero
   [default]
   aws_access_key_id=<AWS_ACCESS_KEY_ID>
   aws_secret_access_key=<AWS_SECRET_ACCESS_KEY>
   EOF

   在安装 Data Protection Application 时，您可以使用 credentials-velero 文件创建 Secret 对象。

流程

1. 点 Operators → Installed Operators 并选择 OADP Operator。
2. 在 Provided APIs 下，点 DataProtectionApplication 框中的 Create 实例。

3. 点 YAML View 并更新 DataProtectionApplication 清单的参数：

   apiVersion: oadp.openshift.io/v1alpha1
   kind: DataProtectionApplication
   metadata:
     name: <dpa_sample>
     namespace: openshift-adp 1
   spec:
     configuration:
       velero:
         defaultPlugins:
           - aws 2
           - openshift 3
         resourceTimeout: 10m 4
       nodeAgent: 5
         enable: true 6
         uploaderType: kopia 7
         podConfig:
           nodeSelector: <node_selector> 8
     backupLocations:
       - velero:
           config:
             profile: "default"
             region: <region_name> 9
             s3Url: <url> 10
             insecureSkipTLSVerify: "true"
             s3ForcePathStyle: "true"
           provider: aws
           default: true
           credential:
             key: cloud
             name: cloud-credentials 11
           objectStorage:
             bucket: <bucket_name> 12
             prefix: <prefix> 13

   1

   OADP 的默认命名空间是 openshift-adp。命名空间是一个变量，可配置。

   2

   需要与您的存储位置对应的对象存储插件。对于所有 S3 供应商，所需的插件都是 aws。对于 Azure 和 GCP 对象存储，需要 azure 或 gcp 插件。

   3

   openshift 插件是必需的。

   4

   指定在超时发生前等待多个 Velero 资源的分钟，如 Velero CRD 可用、volumeSnapshot 删除和备份存储库可用。默认值为 10m。

   5

   将管理请求路由到服务器的管理代理。

   6

   如果要启用 nodeAgent 并执行文件系统备份，则将此值设置为 true。

   7

   输入 kopia 或 restic 作为您的上传者。您不能在安装后更改选择。对于 Built-in DataMover，您必须使用 Kopia。nodeAgent 部署守护进程集，这意味着 nodeAgent pod 在每个工作节点上运行。您可以通过在 Backup CR 中添加 spec.defaultVolumesToFsBackup: true 来配置文件系统备份。

   8

   指定 Kopia 或 Restic 可用的节点。默认情况下，Kopia 或 Restic 在所有节点上运行。

   9

   按照对象存储服务器文档的命名约定，指定地区。

   10

   指定 S3 端点的 URL。

   11

   指定您创建的 Secret 对象的名称。如果没有指定这个值，则使用默认值 cloud-credentials。如果您指定了自定义名称，则使用自定义名称进行备份位置。

   12

   指定存储桶作为备份存储位置。如果存储桶不是 Velero 备份的专用存储桶，您必须指定一个前缀。

   13

   如果存储桶用于多个目的，请为 Velero 备份指定一个前缀，如 velero。

4. 点 Create。

验证

1. 运行以下命令，查看 OpenShift API for Data Protection (OADP) 资源来验证安装：

   $ oc get all -n openshift-adp

   输出示例

   NAME                                                     READY   STATUS    RESTARTS   AGE
   pod/oadp-operator-controller-manager-67d9494d47-6l8z8    2/2     Running   0          2m8s
   pod/node-agent-9cq4q                                     1/1     Running   0          94s
   pod/node-agent-m4lts                                     1/1     Running   0          94s
   pod/node-agent-pv4kr                                     1/1     Running   0          95s
   pod/velero-588db7f655-n842v                              1/1     Running   0          95s
   
   NAME                                                       TYPE        CLUSTER-IP       EXTERNAL-IP   PORT(S)    AGE
   service/oadp-operator-controller-manager-metrics-service   ClusterIP   172.30.70.140    <none>        8443/TCP   2m8s
   service/openshift-adp-velero-metrics-svc                   ClusterIP   172.30.10.0      <none>        8085/TCP   8h
   
   NAME                        DESIRED   CURRENT   READY   UP-TO-DATE   AVAILABLE   NODE SELECTOR   AGE
   daemonset.apps/node-agent    3         3         3       3            3           <none>          96s
   
   NAME                                                READY   UP-TO-DATE   AVAILABLE   AGE
   deployment.apps/oadp-operator-controller-manager    1/1     1            1           2m9s
   deployment.apps/velero                              1/1     1            1           96s
   
   NAME                                                           DESIRED   CURRENT   READY   AGE
   replicaset.apps/oadp-operator-controller-manager-67d9494d47    1         1         1       2m9s
   replicaset.apps/velero-588db7f655                              1         1         1       96s

2. 运行以下命令，验证 DataProtectionApplication (DPA) 是否已协调：

   $ oc get dpa dpa-sample -n openshift-adp -o jsonpath='{.status}'

   输出示例

   {"conditions":[{"lastTransitionTime":"2023-10-27T01:23:57Z","message":"Reconcile complete","reason":"Complete","status":"True","type":"Reconciled"}]}

3. 验证 type 被设置为 Reconciled。

4. 运行以下命令，验证备份存储位置并确认 PHASE 为 Available ：

   $ oc get backupstoragelocations.velero.io -n openshift-adp

   输出示例

   NAME           PHASE       LAST VALIDATED   AGE     DEFAULT
   dpa-sample-1   Available   1s               3d16h   true

流程

1. 点 Operators → Installed Operators 并选择 OADP Operator。
2. 在 Provided APIs 下，点 DataProtectionApplication 框中的 Create 实例。

3. 点 YAML View 并更新 DataProtectionApplication 清单的参数：

   apiVersion: oadp.openshift.io/v1alpha1
   kind: DataProtectionApplication
   metadata:
     name: <dpa_sample>
     namespace: openshift-adp 1
   spec:
     configuration:
       velero:
         defaultPlugins:
           - aws 2
           - kubevirt 3
           - csi 4
           - openshift 5
         resourceTimeout: 10m 6
       nodeAgent: 7
         enable: true 8
         uploaderType: kopia 9
         podConfig:
           nodeSelector: <node_selector> 10
     backupLocations:
       - velero:
           provider: gcp 11
           default: true
           credential:
             key: cloud
             name: <default_secret> 12
           objectStorage:
             bucket: <bucket_name> 13
             prefix: <prefix> 14

   1

   OADP 的默认命名空间是 openshift-adp。命名空间是一个变量，可配置。

   2

   需要与您的存储位置对应的对象存储插件。对于所有 S3 供应商，所需的插件都是 aws。对于 Azure 和 GCP 对象存储，需要 azure 或 gcp 插件。

   3

   可选： kubevirt 插件用于 OpenShift Virtualization。

   4

   如果使用 CSI 快照备份 PV，请指定 csi 默认插件。csi 插件使用 Velero CSI beta 快照 API。您不需要配置快照位置。

   5

   openshift 插件是必需的。

   6

   指定在超时发生前等待多个 Velero 资源的分钟，如 Velero CRD 可用、volumeSnapshot 删除和备份存储库可用。默认值为 10m。

   7

   将管理请求路由到服务器的管理代理。

   8

   如果要启用 nodeAgent 并执行文件系统备份，则将此值设置为 true。

   9

   输入 kopia 或 restic 作为您的上传者。您不能在安装后更改选择。对于 Built-in DataMover，您必须使用 Kopia。nodeAgent 部署守护进程集，这意味着 nodeAgent pod 在每个工作节点上运行。您可以通过在 Backup CR 中添加 spec.defaultVolumesToFsBackup: true 来配置文件系统备份。

   10

   指定 Kopia 或 Restic 可用的节点。默认情况下，Kopia 或 Restic 在所有节点上运行。

   11

   指定备份供应商。

   12

   如果备份供应商使用一个默认插件，为 Secret 指定正确的默认名称，如 cloud-credentials-gcp。如果指定了一个自定义名称，则使用自定义名称用于备份位置。如果没有指定 Secret 名称，则使用默认名称。

   13

   指定存储桶作为备份存储位置。如果存储桶不是 Velero 备份的专用存储桶，您必须指定一个前缀。

   14

   如果存储桶用于多个目的，请为 Velero 备份指定一个前缀，如 velero。

4. 点 Create。

验证

1. 运行以下命令，查看 OpenShift API for Data Protection (OADP) 资源来验证安装：

   $ oc get all -n openshift-adp

   输出示例

   NAME                                                     READY   STATUS    RESTARTS   AGE
   pod/oadp-operator-controller-manager-67d9494d47-6l8z8    2/2     Running   0          2m8s
   pod/node-agent-9cq4q                                     1/1     Running   0          94s
   pod/node-agent-m4lts                                     1/1     Running   0          94s
   pod/node-agent-pv4kr                                     1/1     Running   0          95s
   pod/velero-588db7f655-n842v                              1/1     Running   0          95s
   
   NAME                                                       TYPE        CLUSTER-IP       EXTERNAL-IP   PORT(S)    AGE
   service/oadp-operator-controller-manager-metrics-service   ClusterIP   172.30.70.140    <none>        8443/TCP   2m8s
   service/openshift-adp-velero-metrics-svc                   ClusterIP   172.30.10.0      <none>        8085/TCP   8h
   
   NAME                        DESIRED   CURRENT   READY   UP-TO-DATE   AVAILABLE   NODE SELECTOR   AGE
   daemonset.apps/node-agent    3         3         3       3            3           <none>          96s
   
   NAME                                                READY   UP-TO-DATE   AVAILABLE   AGE
   deployment.apps/oadp-operator-controller-manager    1/1     1            1           2m9s
   deployment.apps/velero                              1/1     1            1           96s
   
   NAME                                                           DESIRED   CURRENT   READY   AGE
   replicaset.apps/oadp-operator-controller-manager-67d9494d47    1         1         1       2m9s
   replicaset.apps/velero-588db7f655                              1         1         1       96s

2. 运行以下命令，验证 DataProtectionApplication (DPA) 是否已协调：

   $ oc get dpa dpa-sample -n openshift-adp -o jsonpath='{.status}'

   输出示例

   {"conditions":[{"lastTransitionTime":"2023-10-27T01:23:57Z","message":"Reconcile complete","reason":"Complete","status":"True","type":"Reconciled"}]}

3. 验证 type 被设置为 Reconciled。

4. 运行以下命令，验证备份存储位置并确认 PHASE 为 Available ：

   $ oc get backupstoragelocations.velero.io -n openshift-adp

   输出示例

   NAME           PHASE       LAST VALIDATED   AGE     DEFAULT
   dpa-sample-1   Available   1s               3d16h   true

流程

1. 根据您的存储供应商说明安装 OADP Operator。
2. 使用 kubevirt 和 openshift OADP 插件安装数据保护应用程序(DPA)。

3. 通过创建 Backup 自定义资源(CR) 来备份虚拟机。

   警告

   红帽支持仅限于以下选项：

   • CSI 备份
   • 使用 DataMover 的 CSI 备份。

流程

1. 点 Operators → Installed Operators 并选择 OADP Operator。
2. 在 Provided APIs 下，点 DataProtectionApplication 框中的 Create 实例。

3. 点 YAML View 并更新 DataProtectionApplication 清单的参数：

   apiVersion: oadp.openshift.io/v1alpha1
   kind: DataProtectionApplication
   metadata:
     name: <dpa_sample>
     namespace: openshift-adp 1
   spec:
     configuration:
       velero:
         defaultPlugins:
           - kubevirt 2
           - gcp 3
           - csi 4
           - openshift 5
         resourceTimeout: 10m 6
       nodeAgent: 7
         enable: true 8
         uploaderType: kopia 9
         podConfig:
           nodeSelector: <node_selector> 10
     backupLocations:
       - velero:
           provider: gcp 11
           default: true
           credential:
             key: cloud
             name: <default_secret> 12
           objectStorage:
             bucket: <bucket_name> 13
             prefix: <prefix> 14

   1

   OADP 的默认命名空间是 openshift-adp。命名空间是一个变量，可配置。

   2

   OpenShift Virtualization 需要 kubevirt 插件。

   3

   为备份供应商指定插件，如 gcp （如果存在）。

   4

   csi 插件是使用 CSI 快照备份 PV 所必需的。csi 插件使用 Velero CSI beta 快照 API。您不需要配置快照位置。

   5

   openshift 插件是必需的。

   6

   指定在超时发生前等待多个 Velero 资源的分钟，如 Velero CRD 可用、volumeSnapshot 删除和备份存储库可用。默认值为 10m。

   7

   将管理请求路由到服务器的管理代理。

   8

   如果要启用 nodeAgent 并执行文件系统备份，则将此值设置为 true。

   9

   输入 kopia 作为您的上传程序，以使用 Built-in DataMover。nodeAgent 部署守护进程集，这意味着 nodeAgent pod 在每个工作节点上运行。您可以通过在 Backup CR 中添加 spec.defaultVolumesToFsBackup: true 来配置文件系统备份。

   10

   指定 Kopia 可用的节点。默认情况下，Kopia 在所有节点上运行。

   11

   指定备份供应商。

   12

   如果备份供应商使用一个默认插件，为 Secret 指定正确的默认名称，如 cloud-credentials-gcp。如果指定了一个自定义名称，则使用自定义名称用于备份位置。如果没有指定 Secret 名称，则使用默认名称。

   13

   指定存储桶作为备份存储位置。如果存储桶不是 Velero 备份的专用存储桶，您必须指定一个前缀。

   14

   如果存储桶用于多个目的，请为 Velero 备份指定一个前缀，如 velero。

4. 点 Create。

验证

1. 运行以下命令，查看 OpenShift API for Data Protection (OADP) 资源来验证安装：

   $ oc get all -n openshift-adp

   输出示例

   NAME                                                     READY   STATUS    RESTARTS   AGE
   pod/oadp-operator-controller-manager-67d9494d47-6l8z8    2/2     Running   0          2m8s
   pod/node-agent-9cq4q                                     1/1     Running   0          94s
   pod/node-agent-m4lts                                     1/1     Running   0          94s
   pod/node-agent-pv4kr                                     1/1     Running   0          95s
   pod/velero-588db7f655-n842v                              1/1     Running   0          95s
   
   NAME                                                       TYPE        CLUSTER-IP       EXTERNAL-IP   PORT(S)    AGE
   service/oadp-operator-controller-manager-metrics-service   ClusterIP   172.30.70.140    <none>        8443/TCP   2m8s
   service/openshift-adp-velero-metrics-svc                   ClusterIP   172.30.10.0      <none>        8085/TCP   8h
   
   NAME                        DESIRED   CURRENT   READY   UP-TO-DATE   AVAILABLE   NODE SELECTOR   AGE
   daemonset.apps/node-agent    3         3         3       3            3           <none>          96s
   
   NAME                                                READY   UP-TO-DATE   AVAILABLE   AGE
   deployment.apps/oadp-operator-controller-manager    1/1     1            1           2m9s
   deployment.apps/velero                              1/1     1            1           96s
   
   NAME                                                           DESIRED   CURRENT   READY   AGE
   replicaset.apps/oadp-operator-controller-manager-67d9494d47    1         1         1       2m9s
   replicaset.apps/velero-588db7f655                              1         1         1       96s

2. 运行以下命令，验证 DataProtectionApplication (DPA) 是否已协调：

   $ oc get dpa dpa-sample -n openshift-adp -o jsonpath='{.status}'

   输出示例

   {"conditions":[{"lastTransitionTime":"2023-10-27T01:23:57Z","message":"Reconcile complete","reason":"Complete","status":"True","type":"Reconciled"}]}

3. 验证 type 被设置为 Reconciled。

4. 运行以下命令，验证备份存储位置并确认 PHASE 为 Available ：

   $ oc get backupstoragelocations.velero.io -n openshift-adp

   输出示例

   NAME           PHASE       LAST VALIDATED   AGE     DEFAULT
   dpa-sample-1   Available   1s               3d16h   true

1. 支持的备份
2. 支持的增量备份
3. 不支持

流程

1. 使用多个 BSL 配置 DPA。请参见以下示例。

   DPA 示例

   apiVersion: oadp.openshift.io/v1alpha1
   kind: DataProtectionApplication
   #...
   backupLocations:
     - name: aws 1
       velero:
         provider: aws
         default: true 2
         objectStorage:
           bucket: <bucket_name> 3
           prefix: <prefix> 4
         config:
           region: <region_name> 5
           profile: "default"
         credential:
           key: cloud
           name: cloud-credentials 6
     - name: odf 7
       velero:
         provider: aws
         default: false
         objectStorage:
           bucket: <bucket_name>
           prefix: <prefix>
         config:
           profile: "default"
           region: <region_name>
           s3Url: <url> 8
           insecureSkipTLSVerify: "true"
           s3ForcePathStyle: "true"
         credential:
           key: cloud
           name: <custom_secret_name_odf> 9
   #...

   1

   为第一个 BSL 指定名称。

   2

   此参数表示此 BSL 是默认的 BSL。如果没有在 Backup CR 中设置 BSL，则会使用默认的 BSL。您只能将一个 BSL 设置为默认值。

   3

   指定存储桶名称。

   4

   为 Velero 备份指定一个前缀，如 velero。

   5

   指定存储桶的 AWS 区域。

   6

   指定您创建的默认 Secret 对象的名称。

   7

   为第二个 BSL 指定名称。

   8

   指定 S3 端点的 URL。

   9

   为 Secret 指定正确的名称；例如，custom_secret_name_odf。如果没有指定 Secret 名称，则使用默认名称。

2. 指定要在备份 CR 中使用的 BSL。请参见以下示例。

   备份 CR 示例

   apiVersion: velero.io/v1
   kind: Backup
   # ...
   spec:
     includedNamespaces:
     - <namespace> 1
     storageLocation: <backup_storage_location> 2
     defaultVolumesToFsBackup: true

   1

   指定要备份的命名空间。

   2

   指定存储位置。