appleboy/docker-backup-database

docker-backup-database

镜像概述和主要用途

docker-backup-database是一个用于定期备份数据库的Docker镜像，支持将MySQL或Postgres数据库备份到本地磁盘或S3存储（包括AWS S3和Minio）。该镜像提供了灵活的配置选项，可通过环境变量设置备份调度、数据库连接和存储目标，适用于需要自动化数据库备份的场景。

核心功能和特性

• 多数据库支持：兼容Postgres（9、10、11、12、13版本）和MySQL（5.6、5.7、8版本）
• 多存储目标：支持备份到本地磁盘或S3存储（AWS S3、Minio）
• 定时备份：通过cron表达式或预定义调度（如@daily、@weekly）设置定期备份
• 灵活配置：通过环境变量配置数据库连接、存储参数和备份调度

支持的数据库

不同数据库版本对应以下镜像标签：

Postgres

• 9: appleboy/docker-backup-database:postgres-9
• 10: appleboy/docker-backup-database:postgres-10
• 11: appleboy/docker-backup-database:postgres-11
• 12: appleboy/docker-backup-database:postgres-12
• 13: appleboy/docker-backup-database:postgres-13

MySQL

• 5.6: appleboy/docker-backup-database:mysql-5.6
• 5.7: appleboy/docker-backup-database:mysql-5.7
• 8: appleboy/docker-backup-database:mysql-8

使用方法

步骤1：部署Minio和数据库服务

使用docker-compose部署Minio（S3兼容存储）和Postgres数据库服务：

yaml
services:
  minio:
    image: minio/minio:edge
    volumes:
      - data1-1:/data1
    ports:
      - 9000:9000
    environment:
      MINIO_ACCESS_KEY: 1234567890
      MINIO_SECRET_KEY: 1234567890
    command: server /data
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:9000/minio/health/live"]
      interval: 30s
      timeout: 20s
      retries: 3

  postgres:
    image: postgres:12
    restart: always
    volumes:
      - pg-data:/var/lib/postgresql/data
    logging:
      options:
        max-size: "100k"
        max-file: "3"
    environment:
      POSTGRES_USER: db
      POSTGRES_DB: db
      POSTGRES_PASSWORD: db

volumes:
  data1-1:
  pg-data:

步骤2：配置数据库备份服务

添加备份服务到docker-compose，将Postgres数据库备份到Minio S3存储：

yaml
  backup_postgres:
    image: appleboy/docker-backup-database:postgres-12
    logging:
      options:
        max-size: "100k"
        max-file: "3"
    environment:
      # 存储配置
      STORAGE_DRIVER: s3
      STORAGE_ENDPOINT: minio:9000
      STORAGE_BUCKET: test
      STORAGE_REGION: ap-northeast-1
      STORAGE_PATH: backup_postgres
      STORAGE_SSL: "false"
      STORAGE_INSECURE_SKIP_VERIFY: "false"
      ACCESS_KEY_ID: 1234567890
      SECRET_ACCESS_KEY: 1234567890
      
      # 数据库配置
      DATABASE_DRIVER: postgres
      DATABASE_HOST: postgres:5432
      DATABASE_USERNAME: db
      DATABASE_PASSWORD: db
      DATABASE_NAME: db
      DATABASE_OPTS:

步骤3：配置定时备份

添加定时任务调度，设置每日备份（以MySQL为例）：

yaml
  backup_mysql:
    image: appleboy/docker-backup-database:mysql-8
    logging:
      options:
        max-size: "100k"
        max-file: "3"
    environment:
      # 存储配置
      STORAGE_DRIVER: s3
      STORAGE_ENDPOINT: minio:9000
      STORAGE_BUCKET: test
      STORAGE_REGION: ap-northeast-1
      STORAGE_PATH: backup_mysql
      STORAGE_SSL: "false"
      ACCESS_KEY_ID: 1234567890
      SECRET_ACCESS_KEY: 1234567890
      
      # 数据库配置
      DATABASE_DRIVER: mysql
      DATABASE_HOST: mysql:3306
      DATABASE_USERNAME: root
      DATABASE_PASSWORD: db
      DATABASE_NAME: db
      DATABASE_OPTS:
      
      # 定时任务配置
      TIME_SCHEDULE: @daily  # 每日执行
      TIME_LOCATION: Asia/Taipei  # 时区

步骤4：管理备份生命周期

使用MinIO Client (mc) 配置备份文件自动过期策略（保留7天）：

sh
# 导入生命周期配置
mc ilm import minio/test <<EOF
{
    "Rules": [
        {
            "Expiration": {
                "Days": 7
            },
            "ID": "backup_postgres",
            "Filter": {
                "Prefix": "backup_postgres/"
            },
            "Status": "Enabled"
        }
    ]
}
EOF

# 查看当前生命周期配置
mc ilm ls minio/test

定时任务调度说明

支持cron表达式或预定义调度：

Cron表达式格式

# ┌───────────── 分钟 (0 - 59)
# │ ┌───────────── 小时 (0 - 23)
# │ │ ┌───────────── 日 (1 - 31)
# │ │ │ ┌───────────── 月 (1 - 12)
# │ │ │ │ ┌───────────── 星期 (0 - 6，0为周日)
# │ │ │ │ │
# * * * * * <命令>

预定义调度

环境变量配置

数据库配置

存储配置

调度配置