第 5 章 control plane 备份和恢复

流程

1. 如果动态置备的存储可用，请完成以下步骤来创建自动重复备份：

   1. 创建名为 etcd-backup-pvc.yaml 的持久性卷声明 (PVC)，其内容如下：

      kind: PersistentVolumeClaim
      apiVersion: v1
      metadata:
        name: etcd-backup-pvc
        namespace: openshift-etcd
      spec:
        accessModes:
          - ReadWriteOnce
        resources:
          requests:
            storage: 200Gi 1
        volumeMode: Filesystem
        storageClassName: etcd-backup-local-storage

      1

      PVC 可用的存储量。根据您的要求调整这个值。

      注意

      每个供应商都需要更改 accessModes 和 storageClassName 密钥：

      供应商	accessModes 值	storageClassName value
      带有 versioned-installer-efc_operator-ci 配置集的 AWS	- ReadWriteMany	efs-sc
      Google Cloud Platform	- ReadWriteMany	filestore-csi
      Microsoft Azure	- ReadWriteMany	azurefile-csi

   2. 运行以下命令来应用 PVC：

      $ oc apply -f etcd-backup-pvc.yaml

   3. 运行以下命令验证 PVC 的创建：

      $ oc get pvc

      输出示例

      NAME              STATUS    VOLUME   CAPACITY   ACCESS MODES   STORAGECLASS   AGE
      etcd-backup-pvc   Bound                                                       51s

      注意

      动态 PVC 处于 Pending 状态，直到它们被挂载为止。

2. 如果动态置备的存储不可用，请完成以下步骤来创建本地存储 PVC：

   警告

   如果您删除或丢失对包含存储备份数据的节点的访问，可能会丢失数据。

   1. 创建名为 etcd-backup-local-storage.yaml 的 StorageClass CR 文件，其内容如下：

      apiVersion: storage.k8s.io/v1
      kind: StorageClass
      metadata:
        name: etcd-backup-local-storage
      provisioner: kubernetes.io/no-provisioner
      volumeBindingMode: Immediate

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

      $ oc apply -f etcd-backup-local-storage.yaml

   3. 从应用的 StorageClass 中创建一个名为 etcd-backup-pv-fs.yaml 的 PV，其内容类似以下示例：

      apiVersion: v1
      kind: PersistentVolume
      metadata:
        name: etcd-backup-pv-fs
      spec:
        capacity:
          storage: 100Gi 1
        volumeMode: Filesystem
        accessModes:
        - ReadWriteMany
        persistentVolumeReclaimPolicy: Delete
        storageClassName: etcd-backup-local-storage
        local:
          path: /mnt/
        nodeAffinity:
          required:
            nodeSelectorTerms:
            - matchExpressions:
              - key: kubernetes.io/hostname
                operator: In
                values:
                - <example_master_node> 2

      1

      PV 可用的存储量。根据您的要求调整这个值。

      2

      将这个值替换为要附加此 PV 的 master 节点。

      提示

      运行以下命令来列出可用的节点：

      $ oc get nodes

   4. 运行以下命令验证 PV 的创建：

      $ oc get pv

      输出示例

      NAME                    CAPACITY   ACCESS MODES   RECLAIM POLICY   STATUS      CLAIM   STORAGECLASS                REASON   AGE
      etcd-backup-pv-fs       100Gi      RWX            Delete           Available           etcd-backup-local-storage            10s

   5. 创建名为 etcd-backup-pvc.yaml 的 PVC，其内容如下：

      kind: PersistentVolumeClaim
      apiVersion: v1
      metadata:
        name: etcd-backup-pvc
      spec:
        accessModes:
        - ReadWriteMany
        volumeMode: Filesystem
        resources:
          requests:
            storage: 10Gi 1
        storageClassName: etcd-backup-local-storage

      1

      PVC 可用的存储量。根据您的要求调整这个值。

   6. 运行以下命令来应用 PVC：

      $ oc apply -f etcd-backup-pvc.yaml

3. 创建名为 etcd-recurring-backups.yaml 的自定义资源定义 (CRD) 文件。创建的 CRD 的内容定义自动备份的调度和保留类型。

   对于带有 15 个保留备份的 RetentionNumber 的默认保留类型，请使用类似以下示例的内容：

   apiVersion: config.openshift.io/v1alpha1
   kind: Backup
   metadata:
     name: etcd-recurring-backup
   spec:
     etcd:
       schedule: "20 4 * * *" 1
       timeZone: "UTC"
       pvcName: etcd-backup-pvc

   1

   用于重复备份的 CronTab 调度。根据您的需要调整这个值。

   要使用基于最大备份数的保留，请在 etcd 键中添加以下键值对：

   spec:
     etcd:
       retentionPolicy:
         retentionType: RetentionNumber 1
         retentionNumber:
           maxNumberOfBackups: 5 2

   1

   保留类型。如果未指定，则默认为 RetentionNumber。

   2

   要保留的最大备份数量。根据您的需要调整这个值。如果未指定，则默认为保留 15 个备份。

   警告

   已知问题会导致保留备份的数量大于配置的值。

   要根据备份的文件大小保留，请使用：

   spec:
     etcd:
       retentionPolicy:
         retentionType: RetentionSize
         retentionSize:
           maxSizeOfBackupsGb: 20 1

   1

   以 GB 为单位保留备份的最大文件大小。根据您的需要调整这个值。如果未指定，则默认为 10 GB。

   警告

   已知问题会导致保留备份的最大大小超过配置的值 10 GB。

4. 运行以下命令，创建 CRD 定义的 cron 作业：

   $ oc create -f etcd-recurring-backup.yaml

5. 要查找创建的 cron 任务，请运行以下命令：

   $ oc get cronjob -n openshift-etcd