silintl/mysql-backup-restore

mysql-backup-restore

使用S3存储服务执行MySQL数据库备份和/或恢复的Docker服务

镜像概述

mysql-backup-restore是一个轻量级Docker镜像，旨在简化MySQL数据库的备份与恢复流程。该镜像通过S3存储服务实现备份文件的存储与读取，支持多数据库批量操作，可通过环境变量灵活配置，适用于开发、测试及生产环境中MySQL数据的备份与恢复需求。

核心功能与特性

• 双模式支持：提供backup（备份）和restore（恢复）两种操作模式
• 多数据库处理：支持同时备份或恢复多个MySQL数据库
• S3集成：通过AWS密钥访问S3存储服务，实现备份文件的云存储
• 灵活配置：通过环境变量自定义数据库连接信息、备份参数及S3存储路径
• 版本控制推荐：建议配合S3 bucket版本控制功能，增强数据安全性

使用场景

• 定期备份MySQL数据库并存储到S3云存储
• 从S3存储的备份文件恢复MySQL数据库
• 跨环境（开发/测试/生产）的数据库迁移
• 自动化部署流程中的数据库备份与恢复步骤

使用方法

前提条件

1. 已创建用于存储备份的S3 bucket
2. 已为S3 bucket开启版本控制（推荐）
3. 已获取MySQL数据库的访问权限（用户名、密码）
4. 已获取具有S3访问权限的AWS密钥（Access Key、Secret Key）

环境变量配置

注意：强烈建议为S3 bucket开启版本控制，以防止备份文件意外覆盖或丢失。

Docker部署示例

备份模式

bash
docker run -d \
  -e MODE=backup \
  -e DB_NAMES=orders users \
  -e MYSQL_USER=root \
  -e MYSQL_PASSWORD=dbpass \
  -e MYSQL_DUMP_ARGS="--single-transaction --quick" \
  -e AWS_ACCESS_KEY=AKIAEXAMPLE \
  -e AWS_SECRET_KEY=secret123 \
  -e S3_BUCKET=s3://my-mysql-backups \
  silintl/mysql-backup-restore

恢复模式

bash
docker run -d \
  -e MODE=restore \
  -e DB_NAMES=orders users \
  -e MYSQL_USER=root \
  -e MYSQL_PASSWORD=dbpass \
  -e AWS_ACCESS_KEY=AKIAEXAMPLE \
  -e AWS_SECRET_KEY=secret123 \
  -e S3_BUCKET=s3://my-mysql-backups \
  silintl/mysql-backup-restore

Docker Hub地址

该镜像在Docker Hub自动构建，镜像地址：https://hub.docker.com/r/silintl/mysql-backup-restore/

本地测试

环境要求

• Docker
• Make

测试步骤

1. 复制环境变量模板并配置：

   bash
   cp local.env.dist local.env
   

   编辑local.env文件，填写MySQL连接信息、AWS密钥及S3 bucket路径

2. 准备测试数据：

   • S3 bucket中需存在.gz格式的备份文件（项目test文件夹提供测试数据库样本）

3. 启动测试环境：

   bash
   make
   

4. 访问本地数据库UI： 测试环境的数据库管理界面将运行在 http://localhost:8001

提示：test文件夹中提供了多个测试数据库样本，可用于本地功能验证。