5장. 컨트롤 플레인 백업 및 복원

프로세스

1. 다음 콘텐츠를 사용하여 enable-tech-preview-no-upgrade.yaml 이라는 FeatureGate CR(사용자 정의 리소스) 파일을 생성합니다.

   apiVersion: config.openshift.io/v1
   kind: FeatureGate
   metadata:
     name: cluster
   spec:
     featureSet: TechPreviewNoUpgrade

2. CR을 적용하고 자동화된 백업을 활성화합니다.

   $ oc apply -f enable-tech-preview-no-upgrade.yaml

3. 관련 API를 활성화하는 데 시간이 걸립니다. 다음 명령을 실행하여 CRD(사용자 정의 리소스 정의) 생성을 확인합니다.

   $ oc get crd | grep backup

   출력 예

   backups.config.openshift.io 2023-10-25T13:32:43Z
   etcdbackups.operator.openshift.io 2023-10-25T13:32:04Z

프로세스

1. 다음 예와 같은 콘텐츠를 사용하여 etcd-single-backup.yaml 이라는 CR 파일을 만듭니다.

   apiVersion: operator.openshift.io/v1alpha1
   kind: EtcdBackup
   metadata:
     name: etcd-single-backup
     namespace: openshift-etcd
   spec:
     pvcName: etcd-backup-pvc <.>

   <.> 백업을 저장할 PVC(영구 볼륨 클레임)의 이름입니다. 환경에 따라 이 값을 조정합니다.

2. CR을 적용하여 단일 백업을 시작합니다.

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

프로세스

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 <.>
        storageClassName: standard-csi <.>
        volumeMode: Filesystem

      PVC에서 사용할 수 있는 스토리지 용량입니다. 요구 사항에 맞게 이 값을 조정합니다. <.> 클레임에 필요한 StorageClass 의 이름입니다. 환경에 따라 이 값을 조정합니다.

      참고

      다음 공급자마다 accessModes 및 storageClassName 키를 변경해야 합니다.

      공급자	accessModes 값	storageClassName value
      버전ed-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   Pending                                      standard-csi   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: WaitForFirstConsumer

   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 <.>
        volumeMode: Filesystem
        accessModes:
        - ReadWriteMany
        persistentVolumeReclaimPolicy: Delete
        storageClassName: local-storage
        local:
          path: /mnt/
        nodeAffinity:
          required:
            nodeSelectorTerms:
            - matchExpressions:
              - key: kubernetes.io/hostname
                operator: In
                values:
                - <example-master-node> <.>

      <.> PV에서 사용할 수 있는 스토리지 용량입니다. 요구 사항에 맞게 이 값을 조정합니다. <.> 이 PV를 연결할 노드로 이 값을 바꿉니다.

      작은 정보

      다음 명령을 실행하여 사용 가능한 노드를 나열합니다.

      $ 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           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 <.>
        storageClassName: local-storage

      PVC에서 사용할 수 있는 스토리지 용량입니다. 요구 사항에 맞게 이 값을 조정합니다.

   6. 다음 명령을 실행하여 PVC를 적용합니다.

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

3. etcd-recurring-backups.yaml 이라는 CRD(사용자 정의 리소스 정의) 파일을 생성합니다. 생성된 CRD의 내용은 자동 백업의 일정 및 보존 유형을 정의합니다.

   15개의 보존된 백업이 있는 보존 Number 의 기본 보존 유형은 다음 예와 같은 내용을 사용합니다.

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

   반복 백업의 CronTab 스케줄입니다. 요구 사항에 맞게 이 값을 조정합니다.

   최대 백업 수에 따라 보존을 사용하려면 다음 키-값 쌍을 etcd 키에 추가합니다.

   spec:
     etcd:
       retentionPolicy:
         retentionType: RetentionNumber <.>
         retentionNumber:
           maxNumberOfBackups: 5 <.>

   <.> 보존 유형. 지정되지 않은 경우 기본값은 RetentionNumber 입니다. <.> 보유할 최대 백업 수입니다. 요구 사항에 맞게 이 값을 조정합니다. 지정되지 않은 경우 기본값은 15 백업입니다.

   주의

   알려진 문제로 인해 보존된 백업 수가 구성된 값보다 큰 문제가 됩니다.

   백업 파일 크기에 따라 보존하려면 다음을 사용합니다.

   spec:
     etcd:
       retentionPolicy:
         retentionType: RetentionSize
         retentionSize:
           maxSizeOfBackupsGb: 20 <.>

   보관된 백업의 최대 파일 크기(GB)입니다. 요구 사항에 맞게 이 값을 조정합니다. 지정되지 않은 경우 기본값은 10GB입니다.

   주의

   알려진 문제로 인해 보존 백업의 최대 크기가 구성된 값보다 최대 10GB가 됩니다.

4. 다음 명령을 실행하여 CRD에서 정의한 cron 작업을 생성합니다.

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

5. 생성된 cron 작업을 찾으려면 다음 명령을 실행합니다.

   $ oc get cronjob -n openshift-etcd