CSI Snapshotter 镜像文档

概述

registry.k8s.io/sig-storage/csi-snapshotter 是由 Kubernetes SIG Storage 维护的 CSI (Container Storage Interface) Snapshotter Sidecar 容器镜像。该镜像实现了 CSI 规范中快照相关的核心操作，作为 CSI 驱动部署的一部分，与 Kubernetes VolumeSnapshot API 集成，负责处理快照的创建、删除、查询等生命周期管理。

功能特性

• 处理 CSI 驱动的快照相关 RPC 请求，包括 CreateSnapshot, DeleteSnapshot, ListSnapshots, GetSnapshot 等
• 与 Kubernetes Snapshot Controller 协同工作，同步快照元数据与集群状态
• 支持 CSI 1.0+ 规范，兼容主流 CSI 存储驱动
• 提供快照操作的状态更新与事件上报，便于集群监控与问题排查
• 可配置日志级别与输出格式，支持调试与审计需求

使用场景

适用于需要为 Kubernetes 集群中的 CSI 卷提供快照功能的环境，典型场景包括：

• 数据库、消息队列等有状态应用的数据定期备份
• 基于快照的数据迁移与克隆
• 灾难恢复场景下的卷数据恢复
• 开发/测试环境的数据快速复制

该镜像需与实现 CSI 快照功能的存储驱动（如 Ceph CSI、AWS EBS CSI、GCP PD CSI 等）配合使用。

部署示例

以下是在 CSI 驱动部署中集成 snapshotter sidecar 的基本示例（作为 DaemonSet 或 StatefulSet 的一部分）：

yaml
containers:
- name: csi-snapshotter
  image: registry.k8s.io/sig-storage/csi-snapshotter:v6.2.1  # 请使用最新稳定版本
  args:
    - --csi-address=/csi/csi.sock  # CSI 驱动 socket 文件路径
    - --v=5  # 日志级别（1-10，越高越详细）
    - --timeout=30s  # 快照操作超时时间
  volumeMounts:
    - name: csi-socket-dir
      mountPath: /csi
volumes:
- name: csi-socket-dir
  hostPath:
    path: /var/lib/kubelet/plugins/<csi-driver-name>  # CSI 驱动 socket 所在主机路径
    type: Directory

注意事项

• 依赖 Kubernetes 集群版本 ≥ 1.17（VolumeSnapshot API snapshot.storage.k8s.io/v1beta1 及以上）
• 需提前部署 Kubernetes Snapshot Controller 及相关 CRDs（VolumeSnapshotClass, VolumeSnapshot, VolumeSnapshotContent）
• CSI 驱动需明确声明支持快照功能（通过 ControllerServiceCapability 上报）
• 生产环境建议配置资源限制（resources.limits/requests）及健康检查（livenessProbe/readinessProbe）