ipburger/docker-mysql-volume-backup-cron

镜像概述

本镜像为轻量型MySQL数据库与卷备份解决方案，基于Alpine系统构建，通过cron定时任务实现自动化备份，支持灵活配置存储类型、备份范围及清理规则，满足数据保护需求。

核心功能

1. 定时备份：默认每8小时执行一次，可通过CRON_D_BACKUP自定义cron表达式
2. 数据库备份：支持全库或指定库备份（DBS变量），默认启用--single-transaction=true保障数据一致性
3. 卷备份：通过VOLUME_前缀变量指定挂载卷路径，实现关联卷的同步备份
4. 存储支持：兼容本地文件系统（local）与OpenStack Swift（swift）两种存储方式
5. 备份管理：支持gzip压缩、前缀命名（PREFIX）、自动清理（MAX_BACKUP_FILES+CRON_D_CLEAN_BACKUPS）
6. 快速恢复：提供即时备份、指定/最新备份恢复功能

使用场景

• 生产环境MySQL数据的定期自动备份
• 开发/测试环境数据的快速恢复与版本管理
• 需要将数据备份到本地或OpenStack云存储的场景

配置说明

通用配置

• MYSQL_ROOT_PASSWORD：MySQL root密码（必填）
• MYSQL_HOST：数据库容器名/地址（Docker网络连接时必填）
• CRON_D_BACKUP：备份定时规则（默认每8小时）
• DBS：指定备份数据库列表（空格分隔，默认全库）
• MYSQLDUMP_OPTIONS：mysqldump参数（默认--single-transaction=true）
• PREFIX：备份文件前缀（可选）

本地存储（STORAGE_TYPE=local）

• BACKUP_DIR：本地备份目录（必填）

OpenStack Swift（STORAGE_TYPE=swift）

• OS_TENANT_NAME：租户名
• OS_USERNAME：用户名
• OS_PASSWORD：密码
• OS_AUTH_URL：认证URL
• CONTAINER：Swift容器名

部署示例

每日UTC 1/9/17点备份

bash
docker run -tid --name mysql-backup-cron \
    --net my_network \
    -e MYSQL_ROOT_PASSWORD=your_pwd \
    -e MYSQL_HOST=mysql_container \
    -e BACKUP_DIR=/backup \
    -e PREFIX=prod_db/ \
    -v $(pwd)/backup:/backup ipburger/docker-mysql-volume-backup-cron

每5分钟备份+自动清理（保留30份）

bash
docker run -tid --name mysql-backup-cron \
    --net my_network \
    -e MYSQL_ROOT_PASSWORD=your_pwd \
    -e MYSQL_HOST=mysql_container \
    -e BACKUP_DIR=/backup \
    -e CRON_D_BACKUP="*/5 * * * * root /backup.sh | logger" \
    -e MAX_BACKUP_FILES=30 \
    -e CRON_D_CLEAN_BACKUPS="00 12 * * * bash /delete.sh" \
    -v $(pwd)/backup:/backup ipburger/docker-mysql-volume-backup-cron

常用操作

• 立即备份：docker exec <container> /backup.sh
• 列出备份：docker exec <container> /restore.sh
• 恢复指定备份：docker exec <container> /restore.sh <backup_file.sql.gz>
• 恢复最新备份：docker exec <container> /restore.sh __latest__