7.3. 关于卷快照

流程

1. 使用以下步骤之一防止数据在快照期间写入卷：

   1. 运行以下命令，删除 pod 以确保在快照过程中不会写入卷：

      $ oc delete my-pod

   2. 在使用复制控制器管理的 pod 上将副本数扩展到零。将 count 设为零可防止在删除新 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. 使用以下命令在存储后端上创建的卷的唯一身份，并插入上一步中获取的名称：

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

3. 运行以下命令，使用您在上一步中获得的卷的唯一身份显示快照：

   $ 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

   删除终结器并删除卷快照。