yloeffler/mysql-backup

mysql-backup

该镜像通过cronjob执行mysqldump命令，将MySQL数据库数据备份到容器内的/backup目录，支持多种配置选项和数据恢复功能。

核心功能

• 定时备份：通过CRON_TIME配置备份频率
• 自动配置：链接MySQL容器时可自动加载数据库的主机、端口、用户名和密码
• 备份压缩：支持通过COMPRESS和COMPRESS_CMD参数压缩备份文件
• 备份管理：通过MAX_BACKUPS限制保留的备份数量，自动清理旧备份
• 初始化操作：容器启动时可执行初始化备份（INIT_BACKUP）或恢复最新备份（INIT_RESTORE_LATEST）
• 手动恢复：支持从指定备份文件恢复单个数据库或全量数据库

使用场景

• 生产环境MySQL数据库的定时自动备份
• 开发/测试环境数据库的数据备份与快速恢复
• 需要定期备份并管理备份文件的场景

配置说明

以下环境变量可用于配置镜像：

• MYSQL_HOST：MySQL数据库的主机/IP地址
• MYSQL_PORT：MySQL数据库的端口号（默认3306）
• MYSQL_USER：MySQL数据库的用户名
• MYSQL_PASS：MySQL数据库的密码
• MYSQL_PASS_FILE：存储MySQL密码的秘密文件（可选）
• MYSQL_DB：需要备份的数据库名称，默认备份所有数据库（--all-databases）
• EXTRA_OPTS：传递给mysqldump命令的额外参数
• COMPRESS：是否压缩备份文件（设置该变量启用）
• COMPRESS_CMD：压缩备份文件的命令，默认使用gzip
• CRON_TIME：cron任务的执行间隔，默认每天00:00（0 0 * * *）
• MAX_BACKUPS：保留的备份文件数量，默认无限制
• INIT_BACKUP：容器启动时是否执行初始化备份（设置该变量启用）
• INIT_RESTORE_LATEST：容器启动时是否恢复最新备份（设置该变量启用）

部署示例

直接运行（指定数据库信息）

bash
docker run -d \
    --env MYSQL_HOST=mysql.host \
    --env MYSQL_PORT=3306 \
    --env MYSQL_USER=admin \
    --env MYSQL_PASS=password \
    --volume /host/backup/folder:/backup \
    yloeffler/mysql-backup

链接MySQL容器（自动加载配置）

1. 启动MySQL容器：

bash
docker run -d -p 3306:3306 -e MYSQL_PASS="mypass" --name mysql tutum/mysql

2. 启动备份容器并链接：

bash
docker run -d --link mysql:mysql -v /host/backup/folder:/backup yloeffler/mysql-backup

恢复备份

查看备份列表

bash
docker exec mysql-backup ls /backup

恢复指定备份

• 恢复单个数据库：

bash
docker exec mysql-backup /restore.sh [目标数据库名] [备份文件名]

• 全量恢复：

bash
docker exec mysql-backup /restore.sh [备份文件名]