squareops/mysqldb-backup

MySQL数据库备份至AWS S3 Docker镜像

镜像概述

本Docker镜像提供MySQL数据库备份解决方案，基于Debian的官方MySQL 8.0镜像构建。镜像预配置AWS CLI和Zip工具，可自动执行数据库备份并将备份文件存储到AWS S3桶中。

核心功能与特性

• 基于官方镜像：构建于官方MySQL 8.0 (Debian)镜像，确保兼容性和稳定性
• 预配置工具：内置AWS CLI和Zip压缩工具，无需额外安装依赖
• 安全认证：采用AWS IAM Roles for Service Accounts (IRSA)进行S3认证，避免使用访问密钥和密钥对
• 自动化流程：容器启动后自动执行备份流程，无需手动干预

使用场景

适用于需要定期备份MySQL数据库并存储到AWS S3的场景，包括但不限于：

• 生产环境MySQL数据库的日常备份
• 开发/测试环境数据的快照保存
• 跨区域数据备份与容灾

使用方法与配置说明

环境变量配置

使用前需设置以下必要环境变量：

部署示例

Docker Run命令

bash
docker run -e MYSQL_HOST=mysql-server -e MYSQL_USER=backupuser -e MYSQL_PASSWORD=backuppassword -e MYSQL_BUCKET_URI=s3://my-backup-bucket/mysql -e AWS_DEFAULT_REGION=us-east-1 --name mysql-backup [镜像名称]

注意：需确保容器已配置IRSA（IAM Roles for Service Accounts）以获得S3访问权限，无需额外提供AWS访问密钥。

Docker Compose配置

yaml
version: '3'
services:
  mysql-backup:
    image: docker.xuanyuan.run/[镜像名称]
    environment:
      - MYSQL_HOST=mysql-server
      - MYSQL_USER=backupuser
      - MYSQL_PASSWORD=backuppassword
      - MYSQL_BUCKET_URI=s3://my-backup-bucket/mysql
      - AWS_DEFAULT_REGION=us-east-1
    restart: unless-stopped

备份流程

容器启动后，内置脚本将自动执行以下步骤：

1. 将所有MySQL数据库导出为full-backup.sql文件
2. 使用当前时间戳命名并压缩SQL文件为ZIP归档（格式：backup-YYYYMMDDHHMMSS.zip）
3. 通过AWS CLI将压缩归档上传至指定S3桶
4. 清理本地临时压缩文件
5. 输出备份完成消息