confirm/mysql-backup

confirm/mysql-backup 镜像说明

镜像概述

confirm/mysql-backup是一个用于备份和恢复MySQL或MariaDB容器的Docker镜像，基于mydumper（一款快速MySQL备份工具）实现高效的数据备份与恢复操作。镜像可自动检测链接的数据库容器，并根据其环境变量完成备份/恢复流程。

核心功能

1. 自动检测：自动识别链接的MySQL/MariaDB容器，读取其环境变量（如数据库名称、root密码）进行操作。
2. 备份与恢复：支持备份（默认模式）和恢复两种操作模式。
3. 灵活配置：可自定义备份目录、UID/GID、umask及mydumper/myloader的命令行参数。
4. 压缩备份：默认使用mydumper的压缩功能存储备份文件。

使用场景

• 定期备份MySQL/MariaDB数据库数据。
• 从备份文件恢复数据库到指定状态。
• 跨环境迁移数据库数据（通过备份文件转移）。

配置说明

模式设置

• MODE：指定操作模式，可选值为BACKUP（默认）或RESTORE。

目录配置

• BASE_DIR：备份文件存储的基础目录，默认值为/backup。
• RESTORE_DIR：恢复时使用的备份目录名称（仅在RESTORE模式下生效，默认使用最新备份）。

权限与权限掩码

• BACKUP_UID：备份文件的UID，默认值为666。
• BACKUP_GID：备份文件的GID，默认值为666。
• UMASK：备份文件的权限掩码，默认值为0022。

工具参数

• OPTIONS：传递给mydumper（备份模式）或myloader（恢复模式）的命令行参数，默认备份时启用压缩（-c），恢复时启用表覆盖（-o）。

部署示例

Docker CLI 示例

创建备份

bash
docker run --name my-backup --link my-mysql -v /var/mysql_backups:/backup docker.xuanyuan.run/confirm/mysql-backup

备份完成后容器自动停止，再次运行需执行：

bash
docker start my-backup

恢复备份

bash
docker run --name my-restore --link my-mysql -v /var/mysql_backups:/backup -e MODE=RESTORE docker.xuanyuan.run/confirm/mysql-backup

Docker Compose 示例

yaml
backup:
    image: docker.xuanyuan.run/confirm/mysql-backup
    volumes:
        - ./data/backup:/backup
    links:
        - my-mysql
    restart: "no"

（注：若需恢复，需添加environment: MODE=RESTORE到compose配置中）