1. 前提条件#

1. K8s 版本兼容：
   • VolumeSnapshot v1 稳定版要求 K8s ≥ 1.20（1.17-1.19 为 beta，需开启特性门控 VolumeSnapshotDataSource=true）；
   • 推荐 1.21+，无需手动开启特性门控。
2. CSI 驱动支持快照：
   • 确认驱动是否支持快照：kubectl get csidrivers <驱动名称> -o yaml，查看 volumeSnapshotClasses 字段为 true 则支持；

1
# 示例：检查 NFS CSI 驱动（需 v4.0+ 支持快照）
2
kubectl get csidrivers nfs.csi.k8s.io -o yaml
3
# 示例：检查 Ceph RBD CSI 驱动
4
kubectl get csidrivers rbd.csi.ceph.com -o yaml

常见支持快照的 CSI 驱动：Ceph RBD、AWS EBS、Azure Disk、NFS CSI（v4.0+）。

3. Snapshot Controller 已部署： K8s 1.20+ 集群默认部署（在 kube-system 命名空间），验证：

1
kubectl get pods -n kube-system | grep snapshot-controller

2. 核心步骤：创建 PV 快照#

1
apiVersion: snapshot.storage.k8s.io/v1
2
kind: VolumeSnapshotClass
3
metadata:
4
  name: nfs-csi-snapshotclass  # 自定义快照类名称
5
driver: nfs.csi.k8s.io        # 关联 NFS CSI 驱动
6
deletionPolicy: Delete        # 删除快照时，同步删除后端存储的快照数据（可选 Retain）
7
parameters:
8
  # NFS CSI 快照无需额外参数（驱动自动复制目录）
9
  # 若需自定义快照目录，可添加：snapshotDir: /data/nfs-snapshots

1
apiVersion: snapshot.storage.k8s.io/v1
2
kind: VolumeSnapshotClass
3
metadata:
4
  name: rbd-csi-snapshotclass
5
driver: rbd.csi.ceph.com
6
deletionPolicy: Delete
7
parameters:
8
  clusterID: my-cluster                # Ceph 集群 ID
9
  csi.storage.k8s.io/snapshotter-secret-name: ceph-csi-secret  # 认证 Secret
10
  csi.storage.k8s.io/snapshotter-secret-namespace: default     # Secret 命名空间

1
# NFS 示例
2
kubectl apply -f nfs-snapshotclass.yaml
3
# Ceph RBD 示例
4
kubectl apply -f rbd-snapshotclass.yaml
5

6
# 验证快照类
7
kubectl get volumesnapshotclasses.snapshot.storage.k8s.io
8
# 简写
9
kubectl get vsclass

1
apiVersion: snapshot.storage.k8s.io/v1
2
kind: VolumeSnapshot
3
metadata:
4
  name: nfs-pvc-snapshot  # 自定义快照名称
5
spec:
6
  volumeSnapshotClassName: nfs-csi-snapshotclass  # 关联上述快照类
7
  source:
8
    persistentVolumeClaimName: csi-nfs-dynamic-pvc  # 要快照的 PVC 名称（必须 Bound）

1
kubectl apply -f nfs-snapshot.yaml
2

3
# 查看快照状态（ReadyToUse 为 true 表示快照创建成功）
4
kubectl get volumesnapshots.snapshot.storage.k8s.io nfs-pvc-snapshot
5
# 简写
6
kubectl get vs

1
NAME                READYTOUSE   SOURCEPVC               SOURCESNAPSHOTCONTENT   RESTORESIZE   SNAPSHOTCLASS          SNAPSHOTCONTENT                                    CREATIONTIME   AGE
2
nfs-pvc-snapshot    true         csi-nfs-dynamic-pvc     <none>                  5Gi           nfs-csi-snapshotclass   snapcontent-xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx   10s            15s

1
kubectl get volumesnapshotcontents.snapshot.storage.k8s.io
2
# 简写
3
kubectl get vsc

1
# NFS 服务端执行
2
ls -l /data/nfs-root/<PVC 对应的子目录>/snapshot-<snapshot-id>/

1
rbd snap ls rbd/<镜像名>

3. 从快照恢复为新 PVC/PV#

创建快照后，可基于快照恢复出全新的 PVC（进而自动创建 PV），步骤如下：

1
apiVersion: v1
2
kind: PersistentVolumeClaim
3
metadata:
4
  name: nfs-restore-pvc  # 恢复后的 PVC 名称
5
spec:
6
  accessModes:
7
    - ReadWriteMany
8
  resources:
9
    requests:
10
      storage: 5Gi  # 需 ≤ 快照的容量（RESTORESIZE 字段）
11
  storageClassName: csi-nfs-sc  # 需与原快照的存储类一致
12
  dataSource:
13
    name: nfs-pvc-snapshot  # 关联已创建的快照名称
14
    kind: VolumeSnapshot
15
    apiGroup: snapshot.storage.k8s.io

1
kubectl apply -f nfs-restore-pvc.yaml
2

3
# 验证恢复后的 PVC 状态（Bound 为成功）
4
kubectl get pvc nfs-restore-pvc

4. 关键注意事项#

1. CSI 驱动兼容性：
   • 并非所有 CSI 驱动都支持快照（如早期版本的 NFS CSI 不支持，需升级到 v4.0+）；
   • 块存储（Ceph RBD/EBS）的快照支持更完善，文件存储（NFS）需驱动实现目录复制逻辑。
2. 快照删除策略：
   • deletionPolicy: Delete：删除 VolumeSnapshot 时，自动删除后端存储的快照数据和 VolumeSnapshotContent；
   • deletionPolicy: Retain：仅删除 VolumeSnapshot，保留后端快照和 VolumeSnapshotContent（需手动清理）。
3. 容量限制： 恢复 PVC 时，请求容量不能超过快照的 RESTORESIZE 字段（可通过 kubectl describe vs <快照名> 查看）。
4. 快照与 PVC 生命周期： 删除原 PVC/PV 不会影响已创建的快照（快照是独立资源），但快照依赖后端存储的原始数据（若手动删除后端存储，快照会失效）。
5. 调试技巧：
   • 查看快照控制器日志：kubectl logs -n kube-system snapshot-controller-xxxx；
   • 查看 CSI 驱动日志（如 NFS CSI）：kubectl logs -n kube-system nfs-csi-controller-xxxx；
   • 查看快照事件：kubectl describe vs <快照名>。

5. 总结#

K8s 中 PV 快照的核心是：

1. 确保 CSI 驱动和 Snapshot Controller 就绪；
2. 创建 VolumeSnapshotClass 定义快照规则；
3. 创建 VolumeSnapshot 关联 PVC 生成快照；
4. 基于快照的 dataSource 恢复新 PVC。

生产环境中，快照常用于数据备份、环境还原、故障恢复等场景，建议结合存储类型（块/文件）选择支持快照的 CSI 驱动，并测试快照/恢复流程的完整性。