candyline/mysql-backup-cron

镜像概述

candyline/mysql-backup-cron是基于nickbreen/mysql-backup-cron分叉的Docker镜像，用于定时备份MySQL数据库，支持多种存储目的地，提供灵活的配置选项以满足不同备份需求。

核心功能

• 定时备份：默认每8小时执行一次，可通过CRON_D_BACKUP自定义cron表达式调整频率。
• 多数据库支持：默认备份所有数据库，也可通过DBS指定特定数据库列表。
• 压缩存储：备份文件自动使用gzip压缩，节省存储空间。
• 多存储目的地：支持本地文件系统、AWS S3、OpenStack Swift、Google Cloud Storage（GCS）。
• 即时操作：可手动触发备份或从指定/最新备份文件恢复数据。
• 备份清理：可选启用每日清理功能，保留指定数量的最新备份文件。

使用场景

• 需要定期备份MySQL数据库的应用系统。
• 希望将备份数据存储到云端（如S3、GCS）或本地的用户。
• 需要灵活调整备份频率和保留策略的场景。

配置说明

通用环境变量

存储目的地配置

本地文件系统（local）

• BACKUP_DIR：本地备份目录（必填，需挂载卷到容器内路径）。

AWS S3（s3）

• AWS_ACCESS_KEY_ID：AWS访问密钥ID（必填）。
• AWS_SECRET_ACCESS_KEY：AWS秘密访问密钥（必填）。
• S3_BUCKET：S3桶路径（格式：s3://bucket/或s3://bucket/prefix/，必填）。
• REGION：AWS区域（默认：us-east-1）。

OpenStack Swift（swift）

• OS_TENANT_NAME：租户名称（必填）。
• OS_USERNAME：用户名（必填）。
• OS_PASSWORD：密码（必填）。
• OS_AUTH_URL：认证URL（必填）。
• CONTAINER：Swift容器名称（必填）。

Google Cloud Storage（gcs）

• BOTO_PATH：BOTO配置文件路径（容器内路径，必填）。
• GC_BUCKET：GCS桶名称（必填）。

部署示例

Docker Run 示例

每日3次备份到本地

bash
docker run -tid --name mysql-backup-cron \
    --net my_network_name \
    -e MYSQL_ROOT_PASSWORD=my_root_password \
    -e MYSQL_HOST=mysql_host \
    -e BACKUP_DIR=/backup \
    -e PREFIX=my-app-backup/ \
    -v $(pwd)/backup:/backup \
    candyline/mysql-backup-cron

每5分钟备份到本地

bash
docker run -tid --name mysql-backup-cron \
    --net my_network_name \
    -e MYSQL_ROOT_PASSWORD=my_root_password \
    -e MYSQL_HOST=mysql_host \
    -e BACKUP_DIR=/backup \
    -e CRON_D_BACKUP="*/5 * * * * root /backup.sh | logger" \
    -e PREFIX=my-app-backup/ \
    -v $(pwd)/backup:/backup \
    candyline/mysql-backup-cron

手动操作

即时备份

bash
docker exec <container_name> /backup.sh

恢复备份

列出可用备份

bash
docker exec <container_name> /restore.sh

恢复指定备份

bash
docker exec <container_name> /restore.sh <backup_filename>

恢复最新备份

bash
docker exec <container_name> /restore.sh __latest__

备份文件格式

备份文件命名格式为：YYYY-MM-DD-HHMMSS.sql.gz，例如：2017-01-20-000252.sql.gz。

修订历史

• 2.4.5：修复备份文件路径父目录意外删除问题。
• 2.4.4：修复ls无法递归显示文件问题。
• 2.4.3：添加GCS备份子目录路径支持。
• 2.4.2：修复sed表达式错误。
• 2.4.1：修复GCS备份时意外创建目录问题。
• 2.4.0：新增GCS存储类型。
• 2.3.1：修复本地恢复路径含分隔符导致文件复制失败问题。
• 2.3.0：修复--events缺失问题；新增从最新备份恢复功能；清理/tmp临时目录；修复恢复时前缀含分隔符无法创建子目录问题。
• 2.2.1：修复restore.sh脚本。
• 2.2.0：支持PREFIX使用'/'作为分隔符。
• 2.1.0：添加--add-drop-database到mysqldump选项。
• 2.0.0：新增备份清理功能（默认禁用）。
• 1.0.0：基于docker-mysql-backup-cron分叉的初始版本。