容器与云原生 / 系统课时
创建 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:
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预期输出
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 驱动创建后端快照。

deletionPolicy 决定删除 VolumeSnapshot 后后端快照如何处理:Delete 会删除绑定的 Content 和后端快照;Retain 会保留它们,便于管理员后续接管。
创建快照并恢复新卷
下面用一个主实验完成创建与恢复。示例假定源 PVC storage-lab/data-demo 使用 Filesystem 和 ReadWriteOnce,并且 <SNAPSHOT_CLASS> 已替换为与源卷 driver 匹配的 VolumeSnapshotClass。
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预期输出
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 状态:
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预期输出
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 与后端存储逐层排查。