4.9. OADP Data Mover

手順

1. 以下の例のように VolumeSnapshotClass CR を定義します。

   VolumeSnapshotClass CR の例

   apiVersion: snapshot.storage.k8s.io/v1
   deletionPolicy: Retain 1
   driver: openshift-storage.cephfs.csi.ceph.com
   kind: VolumeSnapshotClass
   metadata:
     annotations:
       snapshot.storage.kubernetes.io/is-default-class: true 2
     labels:
       velero.io/csi-volumesnapshot-class: true 3
     name: ocs-storagecluster-cephfsplugin-snapclass
   parameters:
     clusterID: openshift-storage
     csi.storage.k8s.io/snapshotter-secret-name: rook-csi-cephfs-provisioner
     csi.storage.k8s.io/snapshotter-secret-namespace: openshift-storage

   1

   Retain に設定する必要があります。

   2

   true に設定する必要があります。

   3

   true に設定する必要があります。

2. 以下の例のように StorageClass CR を定義します。

   StorageClass CR の例

   kind: StorageClass
   apiVersion: storage.k8s.io/v1
   metadata:
     name: ocs-storagecluster-cephfs
     annotations:
       description: Provides RWO and RWX Filesystem volumes
       storageclass.kubernetes.io/is-default-class: true 1
   provisioner: openshift-storage.cephfs.csi.ceph.com
   parameters:
     clusterID: openshift-storage
     csi.storage.k8s.io/controller-expand-secret-name: rook-csi-cephfs-provisioner
     csi.storage.k8s.io/controller-expand-secret-namespace: openshift-storage
     csi.storage.k8s.io/node-stage-secret-name: rook-csi-cephfs-node
     csi.storage.k8s.io/node-stage-secret-namespace: openshift-storage
     csi.storage.k8s.io/provisioner-secret-name: rook-csi-cephfs-provisioner
     csi.storage.k8s.io/provisioner-secret-namespace: openshift-storage
     fsName: ocs-storagecluster-cephfilesystem
   reclaimPolicy: Delete
   allowVolumeExpansion: true
   volumeBindingMode: Immediate

   1

   true に設定する必要があります。

手順

1. 以下の例のように VolumeSnapshotClass CR を定義します。

   VolumeSnapshotClass CR の例

   apiVersion: snapshot.storage.k8s.io/v1
   deletionPolicy: Retain 1
   driver: openshift-storage.rbd.csi.ceph.com
   kind: VolumeSnapshotClass
   metadata:
     labels:
       velero.io/csi-volumesnapshot-class: true 2
     name: ocs-storagecluster-rbdplugin-snapclass
   parameters:
     clusterID: openshift-storage
     csi.storage.k8s.io/snapshotter-secret-name: rook-csi-rbd-provisioner
     csi.storage.k8s.io/snapshotter-secret-namespace: openshift-storage

   1

   Retain に設定する必要があります。

   2

   true に設定する必要があります。

2. 以下の例のように StorageClass CR を定義します。

   StorageClass CR の例

   kind: StorageClass
   apiVersion: storage.k8s.io/v1
   metadata:
     name: ocs-storagecluster-ceph-rbd
     annotations:
       description: 'Provides RWO Filesystem volumes, and RWO and RWX Block volumes'
   provisioner: openshift-storage.rbd.csi.ceph.com
   parameters:
     csi.storage.k8s.io/fstype: ext4
     csi.storage.k8s.io/provisioner-secret-namespace: openshift-storage
     csi.storage.k8s.io/provisioner-secret-name: rook-csi-rbd-provisioner
     csi.storage.k8s.io/node-stage-secret-name: rook-csi-rbd-node
     csi.storage.k8s.io/controller-expand-secret-name: rook-csi-rbd-provisioner
     imageFormat: '2'
     clusterID: openshift-storage
     imageFeatures: layering
     csi.storage.k8s.io/controller-expand-secret-namespace: openshift-storage
     pool: ocs-storagecluster-cephblockpool
     csi.storage.k8s.io/node-stage-secret-namespace: openshift-storage
   reclaimPolicy: Delete
   allowVolumeExpansion: true
   volumeBindingMode: Immediate

手順

1. 次の例のように CephFS StorageClass CR を作成し、backingSnapshot パラメーターを true に設定します。

   backingSnapshot を true に設定した CephFS StorageClass CR の例

   kind: StorageClass
   apiVersion: storage.k8s.io/v1
   metadata:
     name: ocs-storagecluster-cephfs-shallow
     annotations:
       description: Provides RWO and RWX Filesystem volumes
       storageclass.kubernetes.io/is-default-class: false
   provisioner: openshift-storage.cephfs.csi.ceph.com
   parameters:
     csi.storage.k8s.io/provisioner-secret-namespace: openshift-storage
     csi.storage.k8s.io/provisioner-secret-name: rook-csi-cephfs-provisioner
     csi.storage.k8s.io/node-stage-secret-name: rook-csi-cephfs-node
     csi.storage.k8s.io/controller-expand-secret-name: rook-csi-cephfs-provisioner
     clusterID: openshift-storage
     fsName: ocs-storagecluster-cephfilesystem
     csi.storage.k8s.io/controller-expand-secret-namespace: openshift-storage
     backingSnapshot: true 1
     csi.storage.k8s.io/node-stage-secret-namespace: openshift-storage
   reclaimPolicy: Delete
   allowVolumeExpansion: true
   volumeBindingMode: Immediate

   1

   true に設定する必要があります。

   重要

   CephFS VolumeSnapshotClass および StorageClass CR の Provisioner の値が同じであることを確認してください。

2. 次の例のように Restic Secret CR を設定します。

   Restic Secret CR の例

   apiVersion: v1
   kind: Secret
   metadata:
     name: <secret_name>
     namespace: <namespace>
   type: Opaque
   stringData:
     RESTIC_PASSWORD: <restic_password>

手順

1. 次のコマンドを実行して、VolumeSnapshotClass CR の deletionPolicy フィールドが Retain に設定されていることを確認します。

   $ oc get volumesnapshotclass -A  -o jsonpath='{range .items[*]}{"Name: "}{.metadata.name}{"  "}{"Retention Policy: "}{.deletionPolicy}{"\n"}{end}'

2. 次のコマンドを実行して、VolumeSnapshotClass CR のラベルが true に設定されていることを確認します。

   $ oc get volumesnapshotclass -A  -o jsonpath='{range .items[*]}{"Name: "}{.metadata.name}{"  "}{"labels: "}{.metadata.labels}{"\n"}{end}'

3. 次のコマンドを実行して、StorageClass CR の storageclass.kubernetes.io/is-default-class アノテーションが true に設定されていることを確認します。

   $ oc get storageClass -A  -o jsonpath='{range .items[*]}{"Name: "}{.metadata.name}{"  "}{"annotations: "}{.metadata.annotations}{"\n"}{end}'

4. 次の例のような Data Protection Application (DPA) CR を作成します。

   DPA CR の例

   apiVersion: oadp.openshift.io/v1alpha1
   kind: DataProtectionApplication
   metadata:
     name: velero-sample
     namespace: openshift-adp
   spec:
     backupLocations:
       - velero:
           config:
             profile: default
             region: us-east-1
           credential:
             key: cloud
             name: cloud-credentials
           default: true
           objectStorage:
             bucket: <my_bucket>
             prefix: velero
          provider: aws
       configuration:
         restic:
           enable: false  1
         velero:
           defaultPlugins:
             - openshift
             - aws
             - csi
             - vsm
       features:
         dataMover:
           credentialName: <restic_secret_name> 2
           enable: true 3
           volumeOptionsForStorageClasses: 4
             ocs-storagecluster-cephfs:
               sourceVolumeOptions:
                 accessMode: ReadOnlyMany
                 cacheAccessMode: ReadWriteMany
                 cacheStorageClassName: ocs-storagecluster-cephfs
                 storageClassName: ocs-storagecluster-cephfs-shallow

   1

   enable フィールドにはデフォルト値はありません。有効な値は true または false です。

   2

   OADP 1.2 Data Mover および Ceph を操作するための環境を準備したときに作成した Restic Secret を使用します。Restic Secret を使用しない場合、CR はこのパラメーターのデフォルト値 dm-credential を使用します。

   3

   enable フィールドにはデフォルト値はありません。有効な値は true または false です。

   4

   オプションのパラメーター。各 storageClass ボリュームに対して、異なる VolumeOptionsForStorageClass ラベルのセットを定義できます。この設定では、異なるプロバイダーのボリュームのバックアップが提供されます。オプションの VolumeOptionsForStorageClass パラメーターは通常 CephFS で使用されますが、どのストレージタイプでも使用できます。

手順

1. 次の例のように、Backup CR を作成します。

   Backup CR の例

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

2. 次の手順を実行して、VolumeSnapshotBackup CR の進行状況を監視します。

   1. すべての VolumeSnapshotBackup CR の進行状況を確認するには、次のコマンドを実行します。

      $ oc get vsb -n <app_ns>

   2. 特定の VolumeSnapshotBackup CR の進行状況を確認するには、次のコマンドを実行します。

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

3. VolumeSnapshotBackup CR のステータスが Completed になるまで、数分間待ちます。
4. Restic Secret で指定されたスナップショットがオブジェクトストアに少なくとも 1 つあることを確認します。/<OADP-namespace> という接頭辞を持つ、対象の BackupStorageLocation ストレージプロバイダーでこのスナップショットを確認できます。

手順

1. 次のコマンドを実行して、アプリケーションの namespace を削除します。

   $ oc delete vsb -n <app_namespace> --all

2. 次のコマンドを実行して、バックアップ中に作成された VolumeSnapshotContent CR を削除します。

   $ oc delete volumesnapshotcontent --all

3. 次の例のように、Restore CR を作成します。

   Restore CR の例

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

4. 次の手順を実行して、VolumeSnapshotRestore CR の進行状況を監視します。

   1. すべての VolumeSnapshotRestore CR の進行状況を確認するには、次のコマンドを実行します。

      $ oc get vsr -n <app_ns>

   2. 特定の VolumeSnapshotRestore CR の進行状況を確認するには、次のコマンドを実行します。

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

5. 次のコマンドを実行して、アプリケーションデータが復元されたことを確認します。

   $ oc get route <route_name> -n <app_ns> -ojsonpath="{.spec.host}"

手順

1. 次の例のように、Backup CR を作成します。

   Backup CR の例

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

2. 次の手順を実行して、VolumeSnapshotBackup CR の進行状況を監視します。

   1. すべての VolumeSnapshotBackup CR の進行状況を確認するには、次のコマンドを実行します。

      $ oc get vsb -n <app_ns>

   2. 特定の VolumeSnapshotBackup CR の進行状況を確認するには、次のコマンドを実行します。

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

3. VolumeSnapshotBackup CR のステータスが Completed になるまで、数分間待ちます。
4. Restic Secret で指定されたスナップショットがオブジェクトストアに少なくとも 1 つあることを確認します。/<OADP-namespace> という接頭辞を持つ、対象の BackupStorageLocation ストレージプロバイダーでこのスナップショットを確認できます。

手順

1. 次のコマンドを実行して、アプリケーションの namespace を削除します。

   $ oc delete vsb -n <app_namespace> --all

2. 次のコマンドを実行して、バックアップ中に作成された VolumeSnapshotContent CR を削除します。

   $ oc delete volumesnapshotcontent --all

3. 次の例のように、Restore CR を作成します。

   Restore CR の例

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

4. 次の手順を実行して、VolumeSnapshotRestore CR の進行状況を監視します。

   1. すべての VolumeSnapshotRestore CR の進行状況を確認するには、次のコマンドを実行します。

      $ oc get vsr -n <app_ns>

   2. 特定の VolumeSnapshotRestore CR の進行状況を確認するには、次のコマンドを実行します。

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

5. 次のコマンドを実行して、アプリケーションデータが復元されたことを確認します。

   $ oc get route <route_name> -n <app_ns> -ojsonpath="{.spec.host}"

手順

1. Data Mover を使用したバックアップ後に、アプリケーションのnamespace (バックアップおよびリストアするアプリケーション PVC を含む namespace) に残っているクラスターリソースを削除します。

   $ oc delete vsb -n <app_namespace> --all

2. Data Mover を使用するリストア後に残るクラスターリソースを削除します。

   $ oc delete vsr -n <app_namespace> --all

3. 必要に応じて、Data Mover を使用するバックアップおよびリストア後に残っている VolumeSnapshotContent リソースを削除します。

   $ oc delete volumesnapshotcontent --all

手順

1. 次のコマンドを入力して、Data Mover を使用したバックアップ操作後に残ったクラスターリソースをクリーンアップします。

   1. アプリケーション namespace 上の VSB CRD を削除します。この namespace には、バックアップおよび復元するアプリケーション PVC が含まれています。

      $ oc delete vsb -n <app_namespace> --all

   2. VolumeSnapshot CR を削除します。

      $ oc delete volumesnapshot -A --all

   3. VolumeSnapshotContent CR を削除します。

      $ oc delete volumesnapshotcontent --all

   4. 保護された namespace (Operator がインストールされている namespace) 上の PVC をすべて削除します。

      $ oc delete pvc -n <protected_namespace> --all

   5. namespace 上の ReplicationSource リソースをすべて削除します。

      $ oc delete replicationsource -n <protected_namespace> --all

2. 次のコマンドを入力して、Data Mover を使用したリストア操作後に残ったクラスターリソースをクリーンアップします。

   1. VSR CRD を削除します。

      $ oc delete vsr -n <app-ns> --all

   2. VolumeSnapshot CR を削除します。

      $ oc delete volumesnapshot -A --all

   3. VolumeSnapshotContent CR を削除します。

      $ oc delete volumesnapshotcontent --all

   4. namespace 上の ReplicationDestination リソースをすべて削除します。

      $ oc delete replicationdestination -n <protected_namespace> --all