5.13. OpenShift Virtualization を使用した OADP の設定

手順

1. ストレージプロバイダーの指示に従って、OADP Operator をインストールします。
2. kubevirt および openshift OADP プラグインを使用して Data Protection Application (DPA) をインストールします。

3. Backup カスタムリソース (CR) を作成して、仮想マシンをバックアップします。

   警告

   Red Hat のサポート対象は、次のオプションに限られています。

   • CSI バックアップ
   • DataMover による CSI バックアップ

手順

1. Operators Installed Operators をクリックして、OADP Operator を選択します。
2. Provided APIs で、DataProtectionApplication ボックスの Create instance をクリックします。

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

   Copy to Clipboard Toggle word wrap

   1

   OADP のデフォルトの namespace は openshift-adp です。namespace は変数であり、設定可能です。

   2

   kubevirt プラグインは OpenShift Virtualization に必須です。

   3

   バックアッププロバイダーのプラグインがある場合には、それを指定します (例: gcp)。

   4

   CSI スナップショットを使用して PV をバックアップするには、csi プラグインが必須です。csi プラグインは、Velero CSI ベータスナップショット API を使用します。スナップショットの場所を設定する必要はありません。

   5

   openshift プラグインは必須です。

   6

   Velero CRD の可用性、volumeSnapshot の削除、バックアップリポジトリーの可用性など、タイムアウトが発生するまでに複数の Velero リソースを待機する時間を分単位で指定します。デフォルトは 10m です。

   7

   管理要求をサーバーにルーティングする管理エージェント。

   8

   nodeAgent を有効にして File System Backup を実行する場合は、この値を true に設定します。

   9

   組み込み DataMover を使用するには、アップローダーとして kopia と入力します。nodeAgent はデーモンセットをデプロイします。これは、nodeAgent Pod が各ワーキングノード上で実行されることを意味します。File System Backup を設定するには、spec.defaultVolumesToFsBackup: true を Backup CR に追加します。

   10

   Kopia が利用可能なノードを指定します。デフォルトでは、Kopia はすべてのノードで実行されます。

   11

   バックアッププロバイダーを指定します。

   12

   バックアッププロバイダーにデフォルトのプラグインを使用する場合は、Secret の正しいデフォルト名を指定します (例: cloud-credentials-gcp)。カスタム名を指定すると、そのカスタム名がバックアップの場所に使用されます。Secret 名を指定しない場合は、デフォルトの名前が使用されます。

   13

   Backup Storage Location としてバケットを指定します。バケットが Velero バックアップ専用のバケットでない場合は、接頭辞を指定する必要があります。

   14

   バケットが複数の目的で使用される場合は、Velero バックアップの接頭辞を指定します (例: velero)。

4. Create をクリックします。

検証

1. 次のコマンドを実行して OpenShift API for Data Protection (OADP) リソースを表示し、インストールを検証します。

   $ oc get all -n openshift-adp

   Copy to Clipboard Toggle word wrap

   出力例

   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

   Copy to Clipboard Toggle word wrap

2. 次のコマンドを実行して、DataProtectionApplication (DPA) が調整されていることを確認します。

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

   Copy to Clipboard Toggle word wrap

   出力例

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

   Copy to Clipboard Toggle word wrap

3. type が Reconciled に設定されていることを確認します。

4. 次のコマンドを実行して、Backup Storage Location を確認し、PHASE が Available であることを確認します。

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

   Copy to Clipboard Toggle word wrap

   出力例

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

   Copy to Clipboard Toggle word wrap

手順

1. 次の例に示すように、Backup CR を設定します。

   Backup CR の例

   apiVersion: velero.io/v1
   kind: Backup
   metadata:
     name: vmbackupsingle
     namespace: openshift-adp
   spec:
     snapshotMoveData: true
     includedNamespaces:
     - <vm_namespace> 

   1

   
     labelSelector:
       matchLabels:
         app: <vm_app_name> 

   2

   
     storageLocation: <backup_storage_location_name> 

   3

   Copy to Clipboard Toggle word wrap

   1

   仮想マシンを作成した namespace の名前を指定します。

   2

   バックアップする必要がある仮想マシンの名前を指定します。

   3

   BackupStorageLocation CR の名前を指定します。

2. Backup CR を作成するには、次のコマンドを実行します。

   $ oc apply -f <backup_cr_file_name> 

   1

   Copy to Clipboard Toggle word wrap

   1

   Backup CR ファイルの名前を指定します。

手順

1. 次の例に示すように、Restore CR を設定します。

   Restore CR の例

   apiVersion: velero.io/v1
   kind: Restore
   metadata:
     name: vmrestoresingle
     namespace: openshift-adp
   spec:
     backupName: vmbackupsingle 

   1

   
     restorePVs: true

   Copy to Clipboard Toggle word wrap

   1

   1 つの仮想マシンのバックアップ名を指定します。

2. 1 つの仮想マシンを復元するには、次のコマンドを実行します。

   $ oc apply -f <restore_cr_file_name> 

   1

   Copy to Clipboard Toggle word wrap

   1

   Restore CR ファイルの名前を指定します。

   注記

   仮想マシンのバックアップを復元すると、復元に割り当てられた Ceph Storage 容量が予想よりも高いことに気付く場合があります。この動作は、kubevirt の復元中、および仮想マシンのボリュームタイプが block の場合にのみ発生します。

   rbd sparsify ツールを使用して、ターゲットボリューム上のスペースを再利用します。詳細は、ターゲットボリューム上のスペースの再利用 を参照してください。

手順

1. 多数の仮想マシンのバックアップを作成する前に、次のコマンドを実行して仮想マシンにラベルが付けられていることを確認します。

   $ oc label vm <vm_name> app=<vm_name> -n openshift-adp

   Copy to Clipboard Toggle word wrap

2. 次の例に示すように、Restore CR でラベルセレクターを設定します。

   Restore CR の例

   apiVersion: velero.io/v1
   kind: Restore
   metadata:
     name: singlevmrestore
     namespace: openshift-adp
   spec:
     backupName: multiplevmbackup
     restorePVs: true
     LabelSelectors:
       - matchLabels:
           kubevirt.io/created-by: <datavolume_uid> 

   1

   
       - matchLabels:
           app: <vm_name> 

   2

   Copy to Clipboard Toggle word wrap

   1

   復元する仮想マシンの DataVolume の UID を指定します。たとえば、b6…​53a-ddd7-4d9d-9407-a0c…​e5 です。

   2

   復元する仮想マシンの名前を指定します。たとえば、test-vm です。

3. 仮想マシンを復元するには、次のコマンドを実行します。

   $ oc apply -f <restore_cr_file_name> 

   1

   Copy to Clipboard Toggle word wrap

   1

   Restore CR ファイルの名前を指定します。

検証

1. 次のコマンドを実行して、ノードエージェントのセキュリティーコンテキストが非 root として実行するように設定され、root ファイルシステムが readOnly あることを確認します。

   $ oc get daemonset node-agent -o yaml

   Copy to Clipboard Toggle word wrap

   出力例は次のとおりです。

   apiVersion: apps/v1
   kind: DaemonSet
   metadata:
     ...
     name: node-agent
     namespace: openshift-adp
     ...
   spec:
     ...
     template:
       metadata:
         ...
       spec:
         containers:
         ...
           securityContext:
             allowPrivilegeEscalation: false 

   1

   
             capabilities:
               drop:
               - ALL
             privileged: false 

   2

   
             readOnlyRootFilesystem: true 

   3

   
           ...
         nodeSelector:
           kubernetes.io/os: linux
         os:
           name: linux
         restartPolicy: Always
         schedulerName: default-scheduler
         securityContext:
           runAsNonRoot: true 

   4

   
           seccompProfile:
             type: RuntimeDefault
         serviceAccount: velero
         serviceAccountName: velero
         ....

   Copy to Clipboard Toggle word wrap

   1

   allowPrivilegeEscalation フィールドは false です。

   2

   privileged フィールドは false です。

   3

   root ファイルシステムは読み取り専用です。

   4

   ノードエージェントは root 以外のユーザーとして実行されます。

手順

1. カスタムラベルを追加して、選択した任意のノードでノードエージェントを実行します。

   $ oc label node/<node_name> node-role.kubernetes.io/nodeAgent=""

   Copy to Clipboard Toggle word wrap
   注記

   指定したラベルが、各ノードのラベルと一致する必要があります。

2. ノードのラベル付けに使用したのと同じカスタムラベルを DPA.spec.configuration.nodeAgent.podConfig.nodeSelector フィールドで使用します。

   configuration:
     nodeAgent:
       enable: true
       podConfig:
         nodeSelector:
           node-role.kubernetes.io/nodeAgent: ""

   Copy to Clipboard Toggle word wrap

   次の例は nodeSelector のアンチパターンです。この例は、node-role.kubernetes.io/infra: "" と node-role.kubernetes.io/worker: "" の両方のラベルがノードに存在しない限り機能しません。

       configuration:
         nodeAgent:
           enable: true
           podConfig:
             nodeSelector:
               node-role.kubernetes.io/infra: ""
               node-role.kubernetes.io/worker: ""

   Copy to Clipboard Toggle word wrap

手順

1. 特定のノードに対して同時実行を使用する場合は、それらのノードにラベルを追加します。

   $ oc label node/<node_name> label.io/instance-type='large'

   Copy to Clipboard Toggle word wrap

2. DPA インスタンスの同時実行フィールドを設定します。

     configuration:
       nodeAgent:
         enable: true
         uploaderType: kopia
         loadConcurrency:
           globalConfig: 1 

   1

   
           perNodeConfig:
           - nodeSelector:
                 matchLabels:
                    label.io/instance-type: large 

   2

   
             number: 3 

   3

   Copy to Clipboard Toggle word wrap

   1

   グローバル同時実行数。デフォルト値は 1 です。これは同時実行がなく、1 つの負荷のみが許可されることを意味します。globalConfig 値に制限はありません。

   2

   ノードごとの同時実行性のラベル。

   3

   ノードごとの同時実行数。たとえば、インスタンスのタイプとサイズに基づき、ノードごとに多数の同時実行数を指定できます。ノードごとの同時実行数の範囲は、グローバル同時実行数と同じです。設定ファイルにノードごとの同時実行数とグローバル同時実行数が含まれている場合、ノードごとの同時実行数が優先されます。

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