bittorrent/kube-backup

kube-backup镜像说明

镜像概述

本镜像基于https://github.com/pieterlange/kube-backup%E4%BF%AE%E6%94%B9%EF%BC%8C%E6%8F%90%E4%BE%9BKubernetes%E9%9B%86%E7%BE%A4%E8%B5%84%E6%BA%90%E7%8A%B6%E6%80%81%E7%9A%84%E5%A4%87%E4%BB%BD%E8%83%BD%E5%8A%9B%EF%BC%8C%E5%8F%AF%E4%BD%9C%E4%B8%BAKubernetes CronJob运行，将集群资源定义导出至Git仓库，实现配置版本化管理。

核心功能

• 支持导出指定命名空间的资源（默认全命名空间）
• 可配置需要导出的全局资源类型（如namespace）和普通资源类型（如deployment、configmap等）
• 支持AWS CodeCommit（基于IAM策略）和SSH（基于密钥）两种Git仓库认证方式
• 按Cron调度周期执行备份任务
• 生成结构化的YAML文件目录，便于查看和恢复

使用场景

• Kubernetes集群资源配置的定期备份
• 集群状态的版本控制与追溯
• 灾难恢复时的配置快速恢复
• 多环境（开发、测试、生产）集群配置的统一管理

配置说明

环境变量

认证方式

1. AWS CodeCommit认证

需为集群节点配置IAM策略，允许GitPull和GitPush操作：

yaml
additionalPolicies:
  node: |
    [
      {
        "Effect": "Allow",
        "Action": [
          "codecommit:GitPull",
          "codecommit:GitPush"
        ],
        "Resource": "arn:aws:codecommit:<region>:<account-id>:<repo-name>"
      }
    ]

2. SSH认证

创建包含SSH密钥和已知主机的Secret：

bash
ssh-keygen -f ./id_rsa
ssh-keyscan $GIT_HOST > known_hosts
kubectl create secret generic kube-backup-ssh -n kube-system --from-file=id_rsa --from-file=known_hosts

部署示例（CronJob）

yaml
apiVersion: batch/v1beta1
kind: CronJob
metadata:
  name: kube-backup
  namespace: kube-system
spec:
  schedule: "0 */6 * * *" # 每6小时执行一次
  successfulJobsHistoryLimit: 3
  failedJobsHistoryLimit: 1
  jobTemplate:
    spec:
      template:
        spec:
          containers:
          - name: kube-backup
            image: bittorrent/kube-backup
            env:
            - name: GIT_REPO
              value: "git@github.com:your-username/your-repo.git"
            - name: NAMESPACES
              value: "default,kube-system"
            volumeMounts:
            - name: ssh-volume
              mountPath: /backup/.ssh
          volumes:
          - name: ssh-volume
            secret:
              secretName: kube-backup-ssh
          restartPolicy: OnFailure

注意事项

• 若集群版本低于1.5，需手动清理旧Job以避免资源占用
• 默认不导出Secret资源，需手动添加到RESOURCETYPES变量
• CronJob为Kubernetes alpha特性，需确保集群支持
• 使用RBAC的集群需配置对应的ClusterRole和ClusterRoleBinding（参考rbac.yaml）