dyrnq/snapshot-controller

k8s.gcr.io/sig-storage/snapshot-controller 镜像文档

镜像概述

k8s.gcr.io/sig-storage/snapshot-controller是由Kubernetes SIG Storage维护的官方快照控制器镜像，用于实现Kubernetes卷快照功能的核心控制逻辑。该控制器通过协调Kubernetes API中的VolumeSnapshot和VolumeSnapshotContent资源，管理卷快照的完整生命周期，包括快照的创建、删除及状态同步，是Kubernetes集群中启用卷快照功能的必备组件。

核心功能与特性

核心功能

• VolumeSnapshot资源管理：监听并处理VolumeSnapshot对象的创建、更新和删除事件，确保快照操作按预期执行
• 快照内容协调：管理VolumeSnapshotContent资源，实现VolumeSnapshot与后端存储快照的绑定关系
• 生命周期控制：处理快照创建的重试逻辑、状态更新及错误处理，确保快照操作的可靠性
• CSI驱动交互：与容器存储接口(CSI)驱动协同工作，触发实际的卷快照操作

主要特性

• 符合Kubernetes卷快照API规范（包括v1版本）
• 支持领导者选举，确保高可用性
• 提供详细的操作日志与状态反馈
• 兼容主流CSI存储驱动
• 轻量级设计，资源占用低

使用场景与适用范围

典型使用场景

• Kubernetes集群中需要对持久卷(PV)创建快照以实现数据备份
• 通过快照恢复数据到新卷或原卷
• 跨集群或跨命名空间复制卷数据
• 自动化测试环境中基于快照快速创建一致的测试环境

适用范围

• 运行Kubernetes v1.17+的集群（推荐v1.20+以支持快照API v1版本）
• 已部署并配置CSI存储驱动的环境
• 需要实现卷级数据保护策略的生产环境

使用方法与配置说明

前置条件

• Kubernetes集群已启用VolumeSnapshot API（需部署CRD及API服务）
• 集群中已部署兼容CSI快照功能的存储驱动
• 具有集群管理员权限以部署控制器及相关RBAC资源

部署步骤

1. 部署快照CRD与API服务

在部署snapshot-controller前，需先部署卷快照相关CRD和API服务：

bash
kubectl apply -f https://raw.githubusercontent.com/kubernetes-csi/external-snapshotter/release-6.0/client/config/crd/snapshot.storage.k8s.io_volumesnapshotclasses.yaml
kubectl apply -f https://raw.githubusercontent.com/kubernetes-csi/external-snapshotter/release-6.0/client/config/crd/snapshot.storage.k8s.io_volumesnapshotcontents.yaml
kubectl apply -f https://raw.githubusercontent.com/kubernetes-csi/external-snapshotter/release-6.0/client/config/crd/snapshot.storage.k8s.io_volumesnapshots.yaml

2. 部署snapshot-controller

通过官方YAML文件部署控制器：

bash
# 创建RBAC资源
kubectl apply -f https://raw.githubusercontent.com/kubernetes-csi/external-snapshotter/release-6.0/deploy/kubernetes/snapshot-controller/rbac-snapshot-controller.yaml

# 部署控制器
kubectl apply -f https://raw.githubusercontent.com/kubernetes-csi/external-snapshotter/release-6.0/deploy/kubernetes/snapshot-controller/setup-snapshot-controller.yaml

配置参数

环境变量配置

控制器支持通过环境变量调整行为：

• LOG_LEVEL：日志级别，可选值debug、info、warn、error（默认info）
• LEASE_DURATION：领导者选举租约持续时间（默认15s）
• RENEW_DEADLINE：领导者选举续期截止时间（默认10s）
• RETRY_PERIOD：领导者选举重试周期（默认2s）
• WORKERS：并发工作线程数（默认5）

资源配置调整

部署时可根据集群规模调整资源请求与限制：

yaml
resources:
  requests:
    cpu: 100m
    memory: 128Mi
  limits:
    cpu: 500m
    memory: 256Mi

验证部署

部署完成后，可通过以下命令验证控制器运行状态：

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

预期输出类似：

snapshot-controller-7f9b6c5d8d-2x4zv   1/1     Running   0          5m