loicmahieu/mysql-backup

mysql-backup-s3

该镜像用于将MySQL数据库备份到Amazon S3存储服务，提供灵活的配置选项以满足不同备份需求。

核心功能

• 支持备份单个或多个MySQL数据库
• 可选择是否按数据库生成单独备份文件
• 控制备份文件的保留数量
• 支持启用/禁用GZIP压缩
• 兼容Amazon S3及兼容S3协议的存储服务

使用场景

• 定期自动备份MySQL数据库到S3存储，确保数据安全
• 跨环境迁移MySQL数据时的备份需求
• 对数据库进行版本化备份管理

配置说明

环境变量

• AWS_ACCESS_KEY_ID: AWS访问密钥ID

• AWS_SECRET_ACCESS_KEY: AWS秘密访问密钥

• AWS_DEFAULT_REGION: AWS区域（如cn-north-1）

• S3_BUCKET: 目标S3存储桶名称

• S3_PREFIX: S3中的备份文件前缀路径

• S3_ENDPOINT: 可选，自定义S3端点（用于兼容其他存储服务）

• MYSQL_HOST: MySQL服务器地址

• MYSQL_PORT: MySQL端口（默认：3306）

• MYSQL_USER: MySQL用户名

• MYSQL_PASSWORD: MySQL密码

• MYSQLDUMP_DATABASE: 需备份的数据库列表（默认：--all-databases）

• MYSQLDUMP_OPTIONS: mysqldump命令选项（默认值见Dockerfile）

• MULTI_FILES: 是否按数据库生成单独文件（默认：no）

• BACKUP_KEEP: 保留的备份文件数量（默认：30）

• DISABLE_GZIP: 是否禁用GZIP压缩（默认：yes）

部署示例

测试与开发命令

bash
docker build -t docker-mysql-backup . && \
docker run --rm -it \
  -e MYSQL_HOST=10.3.29.57 \
  -e MYSQL_PORT=3308 \
  -e MYSQL_USER=root \
  -e MYSQL_PASSWORD="" \
  -e S3_BUCKET=test \
  -e S3_PREFIX=test-server \
  -e AWS_ACCESS_KEY_ID=$(cat ~/.aws/credentials | awk '/aws_access_key_id = (.*)/{ print $3 }') \
  -e AWS_SECRET_ACCESS_KEY=$(cat ~/.aws/credentials | awk '/aws_secret_access_key = (.*)/{ print $3 }') \
  -e MULTI_FILES=true \
  docker-mysql-backup

致谢

该镜像灵感主要来自 https://github.com/schickling/dockerfiles/tree/master/mysql-backup-s3