ryaneorth/scheduled-volume-snapshotter

Kubernetes定时卷快照镜像

镜像概述

本镜像专为Kubernetes集群设计，提供定时卷快照功能，通过集成Kubernetes原生VolumeSnapshot API，实现持久卷（PersistentVolume）的自动化定时备份。其核心价值在于简化数据备份流程，确保关键业务数据的定期保存与可恢复性，降低手动操作成本并提升数据安全性。

核心功能和特性

• 定时快照调度：支持基于Cron表达式的灵活调度策略，满足不同频率的备份需求（如 hourly、daily、weekly）。
• 快照生命周期管理：自动清理过期快照，可配置保留数量或保留时长，避免存储资源浪费。
• 多存储后端兼容：适配主流云厂商CSI驱动（AWS EBS、GCP PD、Azure Disk）及开源存储系统（Ceph、NFS等）。
• Kubernetes原生集成：完全遵循Kubernetes VolumeSnapshot v1 API，支持VolumeSnapshotClass、VolumeSnapshotContent等原生资源。
• 可配置快照参数：支持自定义快照标签、存储类指定、快照名称模板等个性化配置。
• 监控与日志：输出结构化日志（JSON格式），支持Prometheus指标暴露，便于集群监控与问题排查。

使用场景和适用范围

典型使用场景

• 生产环境数据备份：为数据库（如MySQL、PostgreSQL）、文件服务（如NFS、MinIO）等核心应用提供定时快照，保障业务数据安全。
• 开发测试环境状态保存：快速保存开发环境配置与数据，支持一键恢复，提升迭代效率。
• 灾备策略补充：作为完整灾备方案的一部分，与跨区域备份、数据同步工具配合使用，增强系统容错能力。

适用范围

• Kubernetes集群版本：v1.20+（需支持VolumeSnapshot v1 API）。
• 存储系统：已部署CSI驱动且支持VolumeSnapshot功能的存储后端。
• 应用类型：使用持久卷（PVC）存储数据的有状态应用（StatefulSet）。

使用方法和配置说明

部署前准备

1. 确保Kubernetes集群已安装VolumeSnapshot CRD（通常由CSI驱动或集群管理员提前部署）。
2. 创建具备以下权限的Service Account：
   • 读取PVC、VolumeSnapshot、VolumeSnapshotClass资源的权限。
   • 创建/删除VolumeSnapshot资源的权限。
3. 准备存储类（StorageClass）对应的VolumeSnapshotClass，明确快照存储位置。

部署示例（Kubernetes CronJob）

以下为通过CronJob部署定时快照任务的示例：

yaml
apiVersion: batch/v1
kind: CronJob
metadata:
  name: pvc-snapshotter
  namespace: default
spec:
  schedule: "0 3 * * *"  # 每天凌晨3点执行
  jobTemplate:
    spec:
      template:
        spec:
          serviceAccountName: snapshotter-sa  # 具备快照操作权限的SA
          containers:
          - name: snapshotter
            image: docker.xuanyuan.run/[镜像名称]:[版本号]  # 替换为实际镜像地址
            env:
            - name: SCHEDULE
              value: "0 3 * * *"  # 与CronJob调度一致（冗余配置，便于容器内日志）
            - name: TARGET_PVC_NAME
              value: "app-data-pvc"  # 目标PVC名称
            - name: TARGET_NAMESPACE
              value: "default"  # PVC所在命名空间
            - name: SNAPSHOT_CLASS
              value: "csi-aws-ebs-snapshotclass"  # 目标VolumeSnapshotClass名称
            - name: RETENTION_DAYS
              value: "7"  # 保留最近7天的快照
            - name: SNAPSHOT_LABELS
              value: '{"backup":"daily","app":"my-app"}'  # 快照标签（JSON格式）
          restartPolicy: OnFailure

配置参数说明

环境变量配置

验证与监控

• 查看快照状态：kubectl get volumesnapshot -n <namespace>
• 查看容器日志：kubectl logs <pod-name> -c snapshotter
• 监控指标：默认暴露8080端口的/metrics端点，包含快照成功/失败次数、执行时长等指标。

注意事项

1. 权限配置：确保Service Account具备足够权限，避免因RBAC限制导致快照创建失败。
2. CSI驱动兼容性：不同存储后端的CSI驱动对快照功能支持存在差异，建议提前测试兼容性。
3. 快照一致性：对于数据库等有状态应用，建议先通过应用层（如FLUSH TABLES WITH READ LOCK）确保数据一致性，再执行快照。
4. 清理策略：同时配置RETENTION_DAYS和RETENTION_COUNT时，将优先按RETENTION_COUNT保留快照。