7.3. ボリュームスナップショットについて

手順

1. 次の 2 つの手順のいずれかを使用して、スナップショットの作成中にデータがボリュームに書き込まれないようにします。

   1. 次のコマンドを実行して、Pod を削除し、スナップショット中にデータがボリュームに書き込まれないようにします。

      $ oc delete my-pod

   2. レプリケーションコントローラーで管理されている Pod 上のレプリカ数をゼロにスケールします。カウントをゼロに設定すると、新しい Pod が削除されたときにすぐに新しい Pod が作成されなくなります。

2. ボリュームへの書き込みがすべて停止したら、以下のようなコマンドを実行します。独自の設定情報を挿入します。

   スナップショット設定の例

   # oc apply -f <<EOF
   apiVersion: snapshot.storage.k8s.io/v1
   kind: VolumeSnapshot 1
   metadata:
     name: <snapshot_name> 2
   spec:
     volumeSnapshotClassName: topolvm-snapclass 3
     source:
       persistentVolumeClaimName: test-claim-thin 4
   EOF

   1

   VolumeSnapshot オブジェクトを作成します。

   2

   スナップショットに指定する名前。

   3

   必要な VolumeSnapshotClass オブジェクトの名前を指定します。

   4

   persistentVolumeClaimName または volumeSnapshotContentName のいずれかを指定します。この例では、test-claim-thin という名前の PVC からスナップショットが作成されます。

3. 次のコマンドを実行して、ストレージドライバーがスナップショットの作成を完了するのを待ちます。

   $ oc wait volumesnapshot/<snapshot_name> --for=jsonpath\='{.status.readyToUse}=true'

次のステップ

1. volumeSnapshot オブジェクトが ReadyToUse 状態にある場合は、今後の PVC 用のボリュームとして復元できます。Pod を再起動するか、レプリカ数を必要な数に戻します。
2. ボリュームスナップショットの作成後に、ソース PVC を新規 Pod に再マウントできます。

手順

1. 次のコマンドを実行して、ボリュームスナップショットの名前を取得します。

   $ oc get volumesnapshot -n <namespace> <snapshot_name> -o 'jsonpath={.status.volumeSnapshotContentName}'

2. 以下のコマンドを使用して、前のステップで取得した名前を挿入して、ストレージバックエンドで作成したボリュームの一意の ID を取得します。

   $ oc get volumesnapshotcontent snapcontent-<retrieved_volume_identity> -o 'jsonpath={.status.snapshotHandle}'

3. 次のコマンドを実行して、前の手順で取得したボリュームの一意 ID を使用してスナップショットを表示し、どのボリュームをバックアップするかを決定します。

   $ sudo lvdisplay <retrieved_snapshot_handle>

   出力例

   --- Logical volume ---
   LV Path                /dev/rhel/732e45ff-f220-49ce-859e-87ccca26b14c
   LV Name                732e45ff-f220-49ce-859e-87ccca26b14c
   VG Name                rhel
   LV UUID                6Ojwc0-YTfp-nKJ3-F9FO-PvMR-Ic7b-LzNGSx
   LV Write Access        read only
   LV Creation host, time rhel-92.lab.local, 2023-08-07 14:45:26 -0500
   LV Pool name           thinpool
   LV Thin origin name    a2d2dcdc-747e-4572-8c83-56cd873d3b07
   LV Status              available
   # open                 0
   LV Size                1.00 GiB
   Mapped size            1.04%
   Current LE             256
   Segments               1
   Allocation             inherit
   Read ahead sectors     auto
   - currently set to     256
   Block device           253:11

4. 以下のコマンドを実行して、LV のマウントに使用するディレクトリーを作成します。

   $ sudo mkdir /mnt/snapshot

5. 次のコマンドを実行して、取得したスナップショットハンドルのデバイス名を使用して LV をマウントします。

   $ sudo mount /dev/<retrieved_snapshot_handle> /mnt/snapshot

6. 次のコマンドを実行して、マウントされた場所からファイルをコピーし、安全な場所に保存します。

   $ sudo cp -r /mnt/snapshot <destination>

手順

1. 次のコマンドを入力して、VolumeSnapshot オブジェクトを永続ボリューム要求のデータソースとして指定して、スナップショットを復元します。

   $ oc apply -f <<EOF
   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: snapshot-restore
   spec:
     accessModes:
     - ReadWriteOnce
     dataSource:
       apiGroup: snapshot.storage.k8s.io
       kind: VolumeSnapshot
       name: my-snap
     resources:
       requests:
         storage: 1Gi
     storageClassName: topolvm-provisioner-thin
   ---
   apiVersion: v1
   kind: Pod
   metadata:
     name: base
   spec:
     containers:
     - command:
         - nginx
   	    - -g
   	    - 'daemon off;'
       image: registry.redhat.io/rhel8/nginx-122@sha256:908ebb0dec0d669caaf4145a8a21e04fdf9ebffbba5fd4562ce5ab388bf41ab2
       name: test-container
       securityContext:
         allowPrivilegeEscalation: false
         capabilities:
           drop:
           - ALL
       volumeMounts:
       - mountPath: /vol
         name: test-vol
     securityContext:
       runAsNonRoot: true
       seccompProfile:
         type: RuntimeDefault
     volumes:
     - name: test-vol
       persistentVolumeClaim:
         claimName: snapshot-restore
   EOF

検証

1. Pod が Ready 状態になるまで待機します。

   $ oc wait --for=condition=Ready pod/base

2. 新規 Pod の準備ができたら、スナップショット内でアプリケーションのデータが正しいことを確認します。

手順

1. 以下の例のように、VolumeSnapshotClass オブジェクトで必要な削除ポリシーを指定します。

   volumesnapshotclass.yaml

   apiVersion: snapshot.storage.k8s.io/v1
   kind: VolumeSnapshotClass
   metadata:
     name: csi-hostpath-snap
   driver: hostpath.csi.k8s.io
   deletionPolicy: Delete 1

   1

   ボリュームスナップショットの削除時に Delete 値を設定すると、VolumeSnapshotContent オブジェクトと共に基礎となるスナップショットが削除されます。Retain 値を設定すると、基礎となるスナップショットと VolumeSnapshotContent オブジェクトの両方が残ります。
   Retain 値を設定し、対応する VolumeSnapshotContent オブジェクトを削除せずに VolumeSnapshot オブジェクトを削除すると、コンテンツは残ります。スナップショット自体はストレージバックエンドにも保持されます。

2. 以下のコマンドを入力してボリュームスナップショットを削除します。

   $ oc delete volumesnapshot <volumesnapshot_name>

   出力例

   volumesnapshot.snapshot.storage.k8s.io "mysnapshot" deleted

3. 削除ポリシーが Retain に設定されている場合は、以下のコマンドを入力してボリュームスナップショットのコンテンツを削除します。

   $ oc delete volumesnapshotcontent <volumesnapshotcontent_name>

4. オプション: VolumeSnapshot オブジェクトが正常に削除されていない場合は、以下のコマンドを実行して残されているリソースのファイナライザーを削除し、削除操作を続行できるようにします。

   重要

   永続ボリューム要求またはボリュームスナップショットのコンテンツのいずれかから VolumeSnapshot オブジェクトへの既存の参照がない場合にのみファイナライザーを削除します。--force オプションを使用する場合でも、すべてのファイナライザーが削除されるまで削除操作でスナップショットオブジェクトは削除されません。

   $ oc patch -n $PROJECT volumesnapshot/$NAME --type=merge -p '{"metadata": {"finalizers":null}}'

   出力例

   volumesnapshotclass.snapshot.storage.k8s.io "csi-ocs-rbd-snapclass" deleted

   ファイナライザーが削除され、ボリュームスナップショットが削除されます。