3. VolumeSnapshotClass：VolumeSnapshotClass的作用、参数配置、与StorageClass的对比

3.1 VolumeSnapshotClass 的核心作用

VolumeSnapshotClass 是 Kubernetes 中用于定义卷快照（VolumeSnapshot）存储类别的集群级资源。它类似于 StorageClass 对 PersistentVolumeClaim（PVC）的作用，为 VolumeSnapshot 提供了“模板”和“驱动映射”。

主要职责包括：

  • 指定快照驱动（Driver）：声明由哪个 CSI（Container Storage Interface）驱动来执行快照操作。
  • 定义快照参数：传递存储后端所需的特定参数，如快照频率、保留策略、存储池等。
  • 设置删除策略：控制当 VolumeSnapshot 对象被删除时，是否同时删除后端存储中的实际快照数据。
  • 提供默认快照类：通过注解 snapshot.storage.kubernetes.io/is-default-class: "true" 标记为默认类，简化用户创建快照时的选择。
关键概念： 没有 VolumeSnapshotClass，VolumeSnapshot 对象无法与 CSI 驱动通信，快照操作将无法执行。它是快照生命周期管理的“策略入口”。

3.2 VolumeSnapshotClass 参数配置详解

一个典型的 VolumeSnapshotClass YAML 清单包含以下核心字段：

apiVersion: snapshot.storage.k8s.io/v1
kind: VolumeSnapshotClass
metadata:
  name: csi-hostpath-snapclass
  annotations:
    snapshot.storage.kubernetes.io/is-default-class: "true"
driver: hostpath.csi.k8s.io
deletionPolicy: Delete
parameters:
  # 存储后端自定义参数
  snapshot-type: "incremental"
  storage-pool: "gold-tier"
字段 类型 说明 示例值
metadata.name string VolumeSnapshotClass 的唯一名称，被 VolumeSnapshot 的 volumeSnapshotClassName 字段引用 csi-hostpath-snapclass
driver string CSI 驱动名称，必须与集群中已注册的 CSIDriver 对象匹配 hostpath.csi.k8s.io
deletionPolicy string 快照删除策略：Delete 表示删除 VolumeSnapshot 时同时删除后端快照数据；Retain 表示保留后端数据 Delete
parameters map[string]string 传递给 CSI 驱动的自定义参数，键值对格式，由具体驱动定义 snapshot-type: incremental
annotations map[string]string 用于标记默认类等元数据，不参与驱动逻辑 snapshot.storage.k8s.io/is-default-class: "true"
版本差异注意： 在 Kubernetes v1.20 之前，VolumeSnapshotClass 的 deletionPolicy 字段位于 spec 下；v1.20 及之后版本将其提升为顶级字段。跨版本迁移时需检查 API 版本兼容性。

3.3 VolumeSnapshotClass 与 StorageClass 的对比

VolumeSnapshotClass 和 StorageClass 在 Kubernetes 存储体系中扮演着平行的角色，但服务于不同的资源类型。以下从多个维度进行对比：

对比维度 StorageClass VolumeSnapshotClass
目标资源 PersistentVolumeClaim（PVC） VolumeSnapshot
核心字段 provisioner、parameters、reclaimPolicy、allowVolumeExpansion driver、parameters、deletionPolicy
驱动类型 CSI 卷驱动（Provisioner） CSI 快照驱动（Driver）
删除策略 reclaimPolicy：Delete 或 Retain，控制 PV 的回收行为 deletionPolicy：Delete 或 Retain，控制快照数据的保留
默认类机制 注解 storageclass.kubernetes.io/is-default-class 注解 snapshot.storage.kubernetes.io/is-default-class
参数传递 传递给 CSI 卷驱动，用于创建卷 传递给 CSI 快照驱动，用于创建快照
生命周期关联 与 PVC/PV 绑定，影响卷的创建和回收 与 VolumeSnapshot/VolumeSnapshotContent 绑定，影响快照的创建和删除

从架构上看，两者的设计模式高度一致：

  • 抽象层：将存储后端的差异通过参数和驱动映射隐藏，用户只需引用类名即可。
  • 策略分离：存储策略（如删除行为、性能等级）与资源使用（PVC/VolumeSnapshot）解耦。
  • 扩展性：通过 parameters 字段支持厂商特定的配置，无需修改 Kubernetes 核心代码。
运维建议： 在部署 CSI 驱动时，建议同时创建对应的 StorageClass 和 VolumeSnapshotClass，并保持参数命名风格一致（如使用相同的 storage-pool 值），便于团队理解和排障。

3.4 VolumeSnapshotClass 与 StorageClass 的关联关系图

下图展示了 VolumeSnapshotClass 和 StorageClass 在 Kubernetes 存储体系中的平行位置，以及它们与 CSI 驱动的交互关系：

VolumeSnapshotClass 与 StorageClass 关联关系 VolumeSnapshotClass 与 StorageClass 关联关系 用户层：PVC / VolumeSnapshot 资源 StorageClass provisioner, parameters, reclaimPolicy VolumeSnapshotClass driver, parameters, deletionPolicy CSI 驱动层：卷驱动 + 快照驱动 存储后端（云存储 / 本地存储 / NAS） 说明：StorageClass 管理卷生命周期，VolumeSnapshotClass 管理快照生命周期，两者通过 CSI 驱动与同一存储后端交互

3.5 版本差异校验要点

在跨 Kubernetes 版本迁移或升级 CSI 驱动时，VolumeSnapshotClass 的以下字段需要重点校验：

  1. API 版本变更：v1.20 之前使用 snapshot.storage.k8s.io/v1beta1，v1.20 及之后使用 snapshot.storage.k8s.io/v1。v1beta1 版本中 deletionPolicy 位于 spec 下。
  2. Driver 名称一致性：VolumeSnapshotClass 的 driver 必须与集群中已注册的 CSIDriver 对象的 spec.driver 完全匹配，包括大小写。
  3. Parameters 兼容性：不同版本的 CSI 驱动可能支持不同的参数集。升级驱动后，需检查旧参数是否被弃用或替换。
  4. 默认类冲突：集群中只能有一个 VolumeSnapshotClass 被标记为默认类。如果存在多个，VolumeSnapshot 创建时将报错。
校验工具建议： 使用 kubectl get volumesnapshotclass -o yaml 导出当前配置，与目标版本的 API 参考文档逐字段比对。对于大规模集群，建议使用 kubectl diff 或自定义脚本进行自动化校验。
← 上一章 📖 返回目录 下一章 →