caesarteam/aws-database-backup

aws-database-backup

镜像概述

aws-database-backup是基于Alpine Linux的容器镜像，设计用于在Kubernetes环境中作为定时任务（CronJob）运行，实现MySQL/PostgreSQL数据库的自动备份，并将备份文件上传至Amazon S3。同时支持Slack集成，可实时通知备份结果。

核心功能

• 支持MySQL和PostgreSQL数据库备份
• 可备份同一数据库主机上的多个数据库
• 使用mysqldump（MySQL）或pg_dump（PostgreSQL）生成完整数据库备份
• 将备份文件上传至Amazon S3存储桶
• Slack集成：备份完成后发送成功/失败通知（含错误详情）
• 支持通过openssl enc -aes-256-cbc加密备份文件

使用场景

• Kubernetes集群中数据库的定时自动备份需求
• 需要将数据库备份持久化存储到Amazon S3的场景
• 希望通过Slack实时监控备份状态的团队或个人

配置说明

环境变量

以下是可配置的环境变量列表：

Slack集成

备份完成后，镜像会向指定Slack频道发送通知：

• 备份成功：发送所有数据库备份完成的通用消息
• 备份失败：发送每个失败数据库的详细错误信息

需先创建Slack Incoming WebHook，再通过上述环境变量配置。

S3存储桶与IAM用户配置

• S3存储桶需开启版本控制（镜像每次备份会覆盖同一路径文件，版本控制可保留历史备份）
• 创建IAM用户并分配最小权限，示例策略如下：

json
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": "s3:ListBucket",
            "Resource": "arn:aws:s3:::<BUCKET NAME>"
        },
        {
            "Sid": "VisualEditor1",
            "Effect": "Allow",
            "Action": ["s3:PutObject"],
            "Resource": "arn:aws:s3:::<BUCKET NAME>/*"
        }
    ]
}

Kubernetes CronJob示例

以下是在Kubernetes中配置定时备份任务的示例（每天凌晨1点执行）：

yaml
apiVersion: v1
kind: Secret
metadata:
  name: aws-secret-access-key
type: Opaque
data:
  aws_secret_access_key: <你的AWS秘密访问密钥（Base64编码）>
---
apiVersion: v1
kind: Secret
metadata:
  name: db-password
type: Opaque
data:
  database_password: <你的数据库密码（Base64编码）>
---
apiVersion: v1
kind: Secret
metadata:
  name: slack-webhook-url
type: Opaque
data:
  slack_webhook_url: <你的Slack WebHook URL（Base64编码）>
---
apiVersion: batch/v1beta1
kind: CronJob
metadata:
  name: my-database-backup
spec:
  schedule: "0 1 * * *"  # 每天凌晨1点执行
  jobTemplate:
    spec:
      template:
        spec:
          containers:
          - name: my-database-backup
            image: benjaminmaynard/aws-database-backup
            imagePullPolicy: Always
            env:
              - name: AWS_ACCESS_KEY_ID
                value: "<你的AWS访问密钥ID>"
              - name: AWS_SECRET_ACCESS_KEY
                valueFrom:
                  secretKeyRef:
                    name: aws-secret-access-key
                    key: aws_secret_access_key
              - name: AWS_DEFAULT_REGION
                value: "<你的S3存储桶区域>"
              - name: AWS_BUCKET_NAME
                value: "<你的S3存储桶名称>"
              - name: AWS_BUCKET_BACKUP_PATH
                value: "<你的S3备份路径>"
              - name: DB_HOST
                value: "<你的数据库主机>"
              - name: DB_PORT
                value: "<你的数据库端口>"
              - name: TARGET_DATABASE_NAMES
                value: "<你的目标数据库名称（多个用逗号分隔）>"
              - name: DB_USER
                value: "<你的数据库用户名>"
              - name: DB_PASSWORD
                valueFrom:
                  secretKeyRef:
                    name: db-password
                    key: database_password
              - name: SLACK_ENABLED
                value: "<true/false>"
              - name: SLACK_CHANNEL
                value: "#chatops"
              - name: SLACK_WEBHOOK_URL
                valueFrom:
                  secretKeyRef:
                    name: slack-webhook-url
                    key: slack_webhook_url
          restartPolicy: Never