5.4. CSI 卷快照

1. 使用以下 YAML 描述的 VolumeSnapshotClass 对象创建一个文件：

   volumesnapshotclass.yaml

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

   1

   用于创建此 VolumeSnapshotClass 对象快照的 CSI 驱动程序名称。该名称必须与存储类的 Provisioner 字段相同，它负责正在进行快照的 PVC。

   注意

   根据用来配置持久性存储的驱动程序，可能需要额外的参数。您还可以使用现有的 VolumeSnapshotClass 对象。

2. 运行以下命令，创建上一步中保存的对象：

   $ oc create -f volumesnapshotclass.yaml

3. 创建 VolumeSnapshot 对象：

   volumesnapshot-dynamic.yaml

   apiVersion: snapshot.storage.k8s.io/v1
   kind: VolumeSnapshot
   metadata:
     name: mysnap
   spec:
     volumeSnapshotClassName: csi-hostpath-snap 1
     source:
       persistentVolumeClaimName: myclaim 2

   1

   卷快照对特定类的请求。如果 volumeSnapshotClassName 设置不存在，且有默认的卷快照类，则会创建一个带有默认卷快照类名称的快照。但如果该字段不存在且不存在默认卷快照类，则不会创建快照。

   2

   绑定到持久性卷的 PersistentVolumeClaim 对象的名称。这指定了您要对什么创建快照。动态置备快照需要这个信息。

4. 运行以下命令，创建上一步中保存的对象：

   $ oc create -f volumesnapshot-dynamic.yaml

1. 除了以上定义卷快照类外，还需要提供 volumeSnapshotContentName 参数的值作为快照的源。

   volumesnapshot-manual.yaml

   apiVersion: snapshot.storage.k8s.io/v1
   kind: VolumeSnapshot
   metadata:
     name: snapshot-demo
   spec:
     source:
       volumeSnapshotContentName: mycontent 1

   1

   预置备快照需要 volumeSnapshotContentName 参数。

2. 运行以下命令，创建上一步中保存的对象：

   $ oc create -f volumesnapshot-manual.yaml

1. 运行以下命令显示所创建的卷快照详情：

   $ oc describe volumesnapshot mysnap

   以下示例显示有关 mysnap 卷快照的详细信息：

   volumesnapshot.yaml

   apiVersion: snapshot.storage.k8s.io/v1
   kind: VolumeSnapshot
   metadata:
     name: mysnap
   spec:
     source:
       persistentVolumeClaimName: myclaim
     volumeSnapshotClassName: csi-hostpath-snap
   status:
     boundVolumeSnapshotContentName: snapcontent-1af4989e-a365-4286-96f8-d5dcd65d78d6 1
     creationTime: "2020-01-29T12:24:30Z" 2
     readyToUse: true 3
     restoreSize: 500Mi

   1

   指向控制器创建的实际存储内容的指针。

   2

   创建快照的时间。快照包含在这个指定时间点上可用的卷内容。

   3

   如果该值设为 true，则快照可用来恢复为一个新 PVC。
   如果该值设为 false，则创建快照。但是，存储后端需要执行额外的任务来使快照可用，以便将其恢复为新卷。例如: Amazon Elastic Block Store 数据可能被移到不同的、更低成本的位置，这个过程可能需要几分钟时间。

2. 要验证卷快照是否已创建，请运行以下命令：

   $ oc get volumesnapshotcontent

   显示指向实际内容的指针。如果 boundVolumeSnapshotContentName 字段已被填充，则代表一个 VolumeSnapshotContent 对象已存在，快照被创建。

3. 要验证快照是否已就绪，请确认 VolumeSnapshot 带有 readyToUse: true。

流程

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

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

流程

1. 在 PVC 上指定 VolumeSnapshot 数据源，如下所示：

   pvc-restore.yaml

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: myclaim-restore
   spec:
     storageClassName: csi-hostpath-sc
     dataSource:
       name: mysnap 1
       kind: VolumeSnapshot 2
       apiGroup: snapshot.storage.k8s.io 3
     accessModes:
       - ReadWriteOnce
     resources:
       requests:
         storage: 1Gi

   1

   VolumeSnapshot 对象的名称，代表作为源的快照。

   2

   必须设置为 VolumeSnapshot 的值。

   3

   必须设置为 snapshot.storage.k8s.io 的值 。

2. 运行以下命令来创建一个 PVC：

   $ oc create -f pvc-restore.yaml

3. 运行以下命令验证恢复的 PVC 是否已创建：

   $ oc get pvc

   此时会显示一个新的 PVC，如 myclaim-restore。

流程

1. 运行以下命令检查当前的配置映射：

   $ oc -n openshift-cluster-csi-drivers get cm/vsphere-csi-config -o yaml

   输出示例

   apiVersion: v1
   data:
     cloud.conf: |+
       # Labels with topology values are added dynamically via operator
       [Global]
       cluster-id = vsphere-01-cwv8p
   
       [VirtualCenter "vcenter.openshift.com"]
       insecure-flag           = true
       datacenters             = DEVQEdatacenter
       migration-datastore-url = ds:///vmfs/volumes/vsan:527320283a8c3163-2faa6dc5949a3a28/
   
   kind: ConfigMap
   metadata:
     creationTimestamp: "2024-03-06T09:46:40Z"
     name: vsphere-csi-config
     namespace: openshift-cluster-csi-drivers
     resourceVersion: "126687"

   在本例中，未配置全局最大快照数，因此应用默认值 3。

2. 运行以下命令来更改快照限制：

   • 设置全局快照限制：

     $ oc patch clustercsidriver/csi.vsphere.vmware.com --type=merge -p '{"spec":{"driverConfig":{"vSphere":{"globalMaxSnapshotsPerBlockVolume": 10}}}}'
     clustercsidriver.operator.openshift.io/csi.vsphere.vmware.com patched

     在本例中，全局限制被改为 10 (globalMaxSnapshotsPerBlockVolume 被设置为 10)。

   • 设置虚拟卷快照限制：

     这个参数只对 Virtual Volumes 数据存储设定限制。如果设置，Virtual Volume maximum snapshot 限制会覆盖全局约束，但如果未设置，则默认为全局限制。

     $ oc patch clustercsidriver/csi.vsphere.vmware.com --type=merge -p '{"spec":{"driverConfig":{"vSphere":{"granularMaxSnapshotsPerBlockVolumeInVVOL": 5}}}}'
     clustercsidriver.operator.openshift.io/csi.vsphere.vmware.com patched

     在本例中，Virtual Volume 限制被改为 5 (granularMaxSnapshotsPerBlockVolumeInVVOL 被设置为 5)。

   • 设置 vSAN 快照限制：

     这个参数只对 vSAN 数据存储设定限制。如果设置，vSAN 最大快照限制会覆盖全局约束，但如果未设置，则默认为全局限制。您可以在 vSAN ESA 设置下设置最大值 32。

     $ oc patch clustercsidriver/csi.vsphere.vmware.com --type=merge -p '{"spec":{"driverConfig":{"vSphere":{"granularMaxSnapshotsPerBlockVolumeInVSAN": 7}}}}'
     clustercsidriver.operator.openshift.io/csi.vsphere.vmware.com patched

     在本例中，vSAN 限制被改为 7 (granularMaxSnapshotsPerBlockVolumeInVSAN 被设置为 7)。