容器与云原生 / 系统课时

创建 VolumeSnapshot 与恢复卷

创建 VolumeSnapshot 与恢复卷

VolumeSnapshot 能把 PVC 的某个时间点状态声明为 Kubernetes 快照资源,并作为新 PVC 的恢复源。本课先确认 CSI 快照能力,再完成“创建快照 → 等待就绪 → 恢复新卷 → 检查绑定与数据”的完整闭环。

学习目标

  • 区分 VolumeSnapshotClass、VolumeSnapshot 与 VolumeSnapshotContent 的职责和作用域。
  • 创建动态快照,并通过 readyToUse 与绑定的 Content 判断是否可恢复。
  • 从快照创建新 PVC,理解绑定模式、删除策略与应用一致性边界。

先确认集群具备快照能力

VolumeSnapshot 只适用于 CSI 卷。VolumeSnapshot、VolumeSnapshotContent 和 VolumeSnapshotClass 属于 snapshot.storage.k8s.io API 组;集群还需要 snapshot controller,以及 CSI 驱动控制器侧的 external-snapshotter,才能把 Kubernetes 对象转换为后端快照操作。

先检查源 PVC 的 CSI driver、快照 API 和可用的 VolumeSnapshotClass:

bash
NS=storage-lab
PVC=data-demo
PV=$(kubectl get pvc "$PVC" -n "$NS" -o jsonpath='{.spec.volumeName}')

kubectl get pv "$PV" -o custom-columns=NAME:.metadata.name,DRIVER:.spec.csi.driver
kubectl api-resources --api-group=snapshot.storage.k8s.io
kubectl get volumesnapshotclass -o custom-columns=NAME:.metadata.name,DRIVER:.driver,POLICY:.deletionPolicy

预期输出

text
NAME      DRIVER
<PV_ID>   <CSI_DRIVER>
NAME                     SHORTNAMES   APIVERSION                   NAMESPACED   KIND
volumesnapshotclasses                 snapshot.storage.k8s.io/v1   false        VolumeSnapshotClass
volumesnapshotcontents                snapshot.storage.k8s.io/v1   false        VolumeSnapshotContent
volumesnapshots                       snapshot.storage.k8s.io/v1   true         VolumeSnapshot
NAME               DRIVER         POLICY
<SNAPSHOT_CLASS>   <CSI_DRIVER>   Delete

实际类名、驱动名和删除策略可能不同。用于动态快照的 VolumeSnapshotClass.driver 必须与源 PV 的 .spec.csi.driver 匹配;若 snapshot.storage.k8s.io 资源不存在,应先安装对应 CRD 和 snapshot controller,而不是继续实验。

看懂三个快照对象的关系

VolumeSnapshotClass 是集群级策略模板,定义 CSI driver、deletionPolicy 和驱动参数;VolumeSnapshot 是命名空间级的快照请求,类似 PVC;VolumeSnapshotContent 是集群级的实际快照表示,类似 PV。动态快照时,控制器为 Snapshot 创建并绑定 Content,external-snapshotter 再通过 CSI 驱动创建后端快照。

VolumeSnapshotClass、VolumeSnapshot、VolumeSnapshotContent 与恢复 PVC 的关系

deletionPolicy 决定删除 VolumeSnapshot 后后端快照如何处理:Delete 会删除绑定的 Content 和后端快照;Retain 会保留它们,便于管理员后续接管。

创建快照并恢复新卷

下面用一个主实验完成创建与恢复。示例假定源 PVC storage-lab/data-demo 使用 Filesystem 和 ReadWriteOnce,并且 <SNAPSHOT_CLASS> 已替换为与源卷 driver 匹配的 VolumeSnapshotClass。

bash
NS=storage-lab
SOURCE_PVC=data-demo
SNAPSHOT=data-demo-snapshot
RESTORED_PVC=data-demo-restore
SNAPSHOT_CLASS='<SNAPSHOT_CLASS>'

cat <<EOF | kubectl apply -f -
apiVersion: snapshot.storage.k8s.io/v1
kind: VolumeSnapshot
metadata:
  name: ${SNAPSHOT}
  namespace: ${NS}
spec:
  volumeSnapshotClassName: ${SNAPSHOT_CLASS}
  source:
    persistentVolumeClaimName: ${SOURCE_PVC}
EOF

kubectl wait -n "$NS" \
  --for=jsonpath='{.status.readyToUse}'=true \
  "volumesnapshot/${SNAPSHOT}" \
  --timeout=5m

SC=$(kubectl get pvc "$SOURCE_PVC" -n "$NS" -o jsonpath='{.spec.storageClassName}')
RESTORE_SIZE=$(kubectl get volumesnapshot "$SNAPSHOT" -n "$NS" -o jsonpath='{.status.restoreSize}')

[ -n "$SC" ] || { echo "source PVC has no StorageClass"; exit 1; }
[ -n "$RESTORE_SIZE" ] || { echo "snapshot restoreSize is empty"; exit 1; }

cat <<EOF | kubectl apply -f -
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: ${RESTORED_PVC}
  namespace: ${NS}
spec:
  storageClassName: ${SC}
  volumeMode: Filesystem
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: ${RESTORE_SIZE}
  dataSource:
    name: ${SNAPSHOT}
    kind: VolumeSnapshot
    apiGroup: snapshot.storage.k8s.io
EOF

预期输出

text
volumesnapshot.snapshot.storage.k8s.io/data-demo-snapshot created
volumesnapshot.snapshot.storage.k8s.io/data-demo-snapshot condition met
persistentvolumeclaim/data-demo-restore created

只有 readyToUse=true 后才应把快照作为恢复源。恢复不是让原 PVC 原地回滚,而是让 provisioner 基于快照创建一个新卷;恢复 PVC 的申请容量不能小于快照的 restoreSize。

验证绑定状态与恢复结果

先同时检查快照绑定关系、StorageClass 的绑定模式和恢复 PVC 状态:

bash
NS=storage-lab
SNAPSHOT=data-demo-snapshot
RESTORED_PVC=data-demo-restore
SC=$(kubectl get pvc "$RESTORED_PVC" -n "$NS" -o jsonpath='{.spec.storageClassName}')

kubectl get volumesnapshot "$SNAPSHOT" -n "$NS" \
  -o custom-columns=NAME:.metadata.name,READY:.status.readyToUse,RESTORE_SIZE:.status.restoreSize,CONTENT:.status.boundVolumeSnapshotContentName
kubectl get storageclass "$SC" -o custom-columns=NAME:.metadata.name,BINDING:.volumeBindingMode
kubectl get pvc "$RESTORED_PVC" -n "$NS" \
  -o custom-columns=NAME:.metadata.name,STATUS:.status.phase,CAPACITY:.status.capacity.storage,VOLUME:.spec.volumeName

预期输出

text
NAME                 READY   RESTORE_SIZE   CONTENT
data-demo-snapshot   true    <VALUE>        <ID>
NAME      BINDING
<VALUE>   <BINDING_MODE>
NAME                STATUS    CAPACITY   VOLUME
data-demo-restore   <PHASE>   <VALUE>    <ID>

如果 StorageClass 使用 Immediate,恢复 PVC 通常会直接收敛为 Bound;使用 WaitForFirstConsumer 时,在出现消费该 PVC 的 Pod 前保持 Pending 可能是正常行为。对象状态收敛后,还应让应用挂载新 PVC,并对关键文件、校验和或数据库内容做业务级核验。

若快照长期未就绪,先执行 kubectl describe volumesnapshot data-demo-snapshot -n storage-lab 查看事件,再沿 snapshot controller、external-snapshotter、CSI driver 与后端存储逐层排查。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

创建 VolumeSnapshot 与恢复卷

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通