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。