4.21. OADP Data Mover

1. バックアップをサポート
2. 増分バックアップをサポート
3. サポート対象外

手順

1. 次の例のように、Backup オブジェクトの YAML ファイルを作成します。

   Backup CR の例

   kind: Backup
   apiVersion: velero.io/v1
   metadata:
     name: backup
     namespace: openshift-adp
   spec:
     csiSnapshotTimeout: 10m0s
     defaultVolumesToFsBackup: 

   1

   
     includedNamespaces:
     - mysql-persistent
     itemOperationTimeout: 4h0m0s
     snapshotMoveData: true 

   2

   
     storageLocation: default
     ttl: 720h0m0s 

   3

   
     volumeSnapshotLocations:
     - dpa-sample-1
   # ...

   1

   fs-backup をオプトアウトするボリュームにのみ Data Mover を使用する場合、true に設定します。ボリュームにデフォルトで Data Mover を使用する場合は false に設定します。

   2

   CSI スナップショットのリモートオブジェクトストレージへの移動を有効にするには、true に設定します。

   3

   ttl フィールドは、作成されたバックアップの保持期間とバックアップされたデータのバックアップを定義します。たとえば、バックアップツールとして Restic を使用している場合、バックアップの有効期限が切れるまで、バックアップされたデータ項目と永続ボリューム(PV)のデータコンテンツが保存されます。ただし、このデータを保存すると、ターゲットのバックアップの場所により多くの領域が使用されます。追加のストレージは、頻繁なバックアップで消費されます。バックアップは、他の期限切れでないバックアップがタイムアウトする前でも作成されます。

   注記

   XFS ファイルシステムを使用してボリュームをフォーマットし、ボリュームの容量が 100% になっている場合は、no space left on device エラーが発生してバックアップが失敗します。以下に例を示します。

   Error: relabel failed /var/lib/kubelet/pods/3ac..34/volumes/ \
   kubernetes.io~csi/pvc-684..12c/mount: lsetxattr /var/lib/kubelet/ \
   pods/3ac..34/volumes/kubernetes.io~csi/pvc-68..2c/mount/data-xfs-103: \
   no space left on device

   このシナリオでは、バックアップが正常に完了するように、ボリュームのサイズを変更するか、ext4 などの別のファイルシステムタイプを使用することを検討してください。

2. マニフェストを適用します。

   $ oc create -f backup.yaml

   スナップショットの作成が完了すると、DataUpload CR が作成されます。

手順

1. 次の例のように、Restore CR の YAML ファイルを作成します。

   Restore CR の例

   apiVersion: velero.io/v1
   kind: Restore
   metadata:
     name: restore
     namespace: openshift-adp
   spec:
     backupName: <backup>
   # ...

2. マニフェストを適用します。

   $ oc create -f restore.yaml

   復元が開始されると、DataDownload が作成されます。

手順

1. 次の例に示すように、Data Protection Application (DPA) を設定します。

   apiVersion: oadp.openshift.io/v1alpha1
   kind: DataProtectionApplication
   metadata:
   name: <dpa_name> 

   1

   
   namespace: openshift-adp
   spec:
   backupLocations:
   - name: aws
     velero:
       config:
         profile: default
         region: <region_name> 

   2

   
       credential:
         key: cloud
         name: cloud-credentials 

   3

   
       default: true
       objectStorage:
         bucket: <bucket_name> 

   4

   
         prefix: velero
       provider: aws
   configuration:
     nodeAgent:
       enable: true
       uploaderType: kopia
     velero:
       defaultPlugins:
       - openshift
       - aws
       - csi 

   5

   
       defaultSnapshotMoveData: true
       podConfig:
         env:
           - name: KOPIA_HASHING_ALGORITHM
             value: BLAKE3-256 

   6

   
           - name: KOPIA_ENCRYPTION_ALGORITHM
             value: CHACHA20-POLY1305-HMAC-SHA256 

   7

   
           - name: KOPIA_SPLITTER_ALGORITHM
             value: DYNAMIC-8M-RABINKARP 

   8

   1

   DPA の名前を指定します。

   2

   Backup Storage Location のリージョンを指定します。

   3

   デフォルトの Secret オブジェクトの名前を指定します。

   4

   AWS S3 バケット名を指定します。

   5

   csi プラグインを含めます。

   6

   ハッシュアルゴリズムを BLAKE3-256 に指定します。

   7

   暗号化アルゴリズムを CHACHA20-POLY1305-HMAC-SHA256 に指定します。

   8

   スプリッターアルゴリズムを DYNAMIC-8M-RABINKARP に指定します。

2. 次のコマンドを実行して DPA を作成します。

   $ oc create -f <dpa_file_name> 

   1

   1

   設定した DPA のファイル名を指定します。

3. 次のコマンドを実行して、DPA が調整されたことを確認します。

   $ oc get dpa -o yaml

4. 次の例に示すように、バックアップ CR を作成します。

   バックアップ CR の例

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

   1

   
     defaultVolumesToFsBackup: true

   1

   クラスターにインストールされているアプリケーションの namespace を指定します。

5. 次のコマンドを実行してバックアップを作成します。

   $ oc apply -f <backup_file_name> 

   1

   1

   バックアップ CR ファイルの名前を指定します。

6. 次のコマンドを実行して、バックアップが完了したことを確認します。

   $ oc get backups.velero.io <backup_name> -o yaml 

   1

   1

   バックアップの名前を指定します。

検証

1. 次のコマンドを実行して、Kopia リポジトリーに接続します。

   $ kopia repository connect s3 \
     --bucket=<bucket_name> \ 

   1

   
     --prefix=velero/kopia/<application_namespace> \ 

   2

   
     --password=static-passw0rd \ 

   3

   
     --access-key="<aws_s3_access_key>" \ 

   4

   
     --secret-access-key="<aws_s3_secret_access_key>" \ 

   5

   1

   AWS S3 バケット名を指定します。

   2

   アプリケーションの namespace を指定します。

   3

   これはリポジトリーに接続するための Kopia パスワードです。

   4

   AWS S3 アクセスキーを指定します。

   5

   AWS S3 ストレージプロバイダーのシークレットアクセスキーを指定します。

   注記

   AWS S3 以外のストレージプロバイダーを使用している場合は、コマンドにバケットエンドポイントの URL パラメーター --endpoint を追加する必要があります。

2. 次のコマンドを実行して、バックアップ用に DPA で設定した環境変数を Kopia が使用していることを確認します。

   $ kopia repository status

   出力例

   Config file:         /../.config/kopia/repository.config
   
   Description:         Repository in S3: s3.amazonaws.com <bucket_name>
   # ...
   
   Storage type:        s3
   Storage capacity:    unbounded
   Storage config:      {
                          "bucket": <bucket_name>,
                          "prefix": "velero/kopia/<application_namespace>/",
                          "endpoint": "s3.amazonaws.com",
                          "accessKeyID": <access_key>,
                          "secretAccessKey": "****************************************",
                          "sessionToken": ""
                        }
   
   Unique ID:           58....aeb0
   Hash:                BLAKE3-256
   Encryption:          CHACHA20-POLY1305-HMAC-SHA256
   Splitter:            DYNAMIC-8M-RABINKARP
   Format version:      3
   # ...

手順

1. 以下の例のように、must-gather Pod を設定します。必ず OADP バージョン 1.3 以降の oadp-mustgather イメージを使用してください。

   Pod 設定の例

   apiVersion: v1
   kind: Pod
   metadata:
     name: oadp-mustgather-pod
     labels:
       purpose: user-interaction
   spec:
     containers:
     - name: oadp-mustgather-container
       image: registry.redhat.io/oadp/oadp-mustgather-rhel9:v1.3
       command: ["sleep"]
       args: ["infinity"]

   注記

   Kopia クライアントは oadp-mustgather イメージで利用できます。

2. 以下のコマンドを実行して Pod を作成します。

   $ oc apply -f <pod_config_file_name> 

   1

   1

   Pod 設定用の YAML ファイルの名前を指定します。

3. Kopia がリポジトリーに接続できるように、Pod の Security Context Constraints (SCC) が anyuid であることを確認します。

   $ oc describe pod/oadp-mustgather-pod | grep scc

   出力例

   openshift.io/scc: anyuid

4. 次のコマンドを実行して、SSH 経由で Pod に接続します。

   $ oc -n openshift-adp rsh pod/oadp-mustgather-pod

5. 次のコマンドを実行して、Kopia リポジトリーに接続します。

   sh-5.1# kopia repository connect s3 \
     --bucket=<bucket_name> \ 

   1

   
     --prefix=velero/kopia/<application_namespace> \ 

   2

   
     --password=static-passw0rd \ 

   3

   
     --access-key="<access_key>" \ 

   4

   
     --secret-access-key="<secret_access_key>" \ 

   5

   
     --endpoint=<bucket_endpoint> \ 

   6

   1

   オブジェクトストレージプロバイダーのバケット名を指定します。

   2

   アプリケーションの namespace を指定します。

   3

   これはリポジトリーに接続するための Kopia パスワードです。

   4

   オブジェクトストレージプロバイダーのアクセスキーを指定します。

   5

   オブジェクトストレージプロバイダーのシークレットアクセスキーを指定します。

   6

   バケットのエンドポイントを指定します。ストレージプロバイダーとして AWS S3 を使用している場合は、バケットエンドポイントを指定する必要はありません。

   注記

   これはコマンドの例です。コマンドはオブジェクトストレージプロバイダーによって異なる場合があります。

6. ハッシュアルゴリズムをベンチマークするには、次のコマンドを実行します。

   sh-5.1# kopia benchmark hashing

   出力例

   Benchmarking hash 'BLAKE2B-256' (100 x 1048576 bytes, parallelism 1)
   Benchmarking hash 'BLAKE2B-256-128' (100 x 1048576 bytes, parallelism 1)
   Benchmarking hash 'BLAKE2S-128' (100 x 1048576 bytes, parallelism 1)
   Benchmarking hash 'BLAKE2S-256' (100 x 1048576 bytes, parallelism 1)
   Benchmarking hash 'BLAKE3-256' (100 x 1048576 bytes, parallelism 1)
   Benchmarking hash 'BLAKE3-256-128' (100 x 1048576 bytes, parallelism 1)
   Benchmarking hash 'HMAC-SHA224' (100 x 1048576 bytes, parallelism 1)
   Benchmarking hash 'HMAC-SHA256' (100 x 1048576 bytes, parallelism 1)
   Benchmarking hash 'HMAC-SHA256-128' (100 x 1048576 bytes, parallelism 1)
   Benchmarking hash 'HMAC-SHA3-224' (100 x 1048576 bytes, parallelism 1)
   Benchmarking hash 'HMAC-SHA3-256' (100 x 1048576 bytes, parallelism 1)
        Hash                 Throughput
   -----------------------------------------------------------------
     0. BLAKE3-256           15.3 GB / second
     1. BLAKE3-256-128       15.2 GB / second
     2. HMAC-SHA256-128      6.4 GB / second
     3. HMAC-SHA256          6.4 GB / second
     4. HMAC-SHA224          6.4 GB / second
     5. BLAKE2B-256-128      4.2 GB / second
     6. BLAKE2B-256          4.1 GB / second
     7. BLAKE2S-256          2.9 GB / second
     8. BLAKE2S-128          2.9 GB / second
     9. HMAC-SHA3-224        1.6 GB / second
    10. HMAC-SHA3-256        1.5 GB / second
   -----------------------------------------------------------------
   Fastest option for this machine is: --block-hash=BLAKE3-256

7. 暗号化アルゴリズムをベンチマークするには、次のコマンドを実行します。

   sh-5.1# kopia benchmark encryption

   出力例

   Benchmarking encryption 'AES256-GCM-HMAC-SHA256'... (1000 x 1048576 bytes, parallelism 1)
   Benchmarking encryption 'CHACHA20-POLY1305-HMAC-SHA256'... (1000 x 1048576 bytes, parallelism 1)
        Encryption                     Throughput
   -----------------------------------------------------------------
     0. AES256-GCM-HMAC-SHA256         2.2 GB / second
     1. CHACHA20-POLY1305-HMAC-SHA256  1.8 GB / second
   -----------------------------------------------------------------
   Fastest option for this machine is: --encryption=AES256-GCM-HMAC-SHA256

8. スプリッターアルゴリズムをベンチマークするには、次のコマンドを実行します。

   sh-5.1# kopia benchmark splitter

   出力例

   splitting 16 blocks of 32MiB each, parallelism 1
   DYNAMIC                     747.6 MB/s count:107 min:9467 10th:2277562 25th:2971794 50th:4747177 75th:7603998 90th:8388608 max:8388608
   DYNAMIC-128K-BUZHASH        718.5 MB/s count:3183 min:3076 10th:80896 25th:104312 50th:157621 75th:249115 90th:262144 max:262144
   DYNAMIC-128K-RABINKARP      164.4 MB/s count:3160 min:9667 10th:80098 25th:106626 50th:162269 75th:250655 90th:262144 max:262144
   # ...
   FIXED-512K                  102.9 TB/s count:1024 min:524288 10th:524288 25th:524288 50th:524288 75th:524288 90th:524288 max:524288
   FIXED-8M                    566.3 TB/s count:64 min:8388608 10th:8388608 25th:8388608 50th:8388608 75th:8388608 90th:8388608 max:8388608
   -----------------------------------------------------------------
     0. FIXED-8M                  566.3 TB/s   count:64 min:8388608 10th:8388608 25th:8388608 50th:8388608 75th:8388608 90th:8388608 max:8388608
     1. FIXED-4M                  425.8 TB/s   count:128 min:4194304 10th:4194304 25th:4194304 50th:4194304 75th:4194304 90th:4194304 max:4194304
     # ...
    22. DYNAMIC-128K-RABINKARP    164.4 MB/s   count:3160 min:9667 10th:80098 25th:106626 50th:162269 75th:250655 90th:262144 max:262144