brainbitsgmbh/mariadb-backup

MariaDB Backup 镜像文档

镜像概述

该镜像为MariaDB和MySQL数据库提供简单高效的备份与恢复解决方案。通过mariadb-dump工具创建备份并压缩，支持通过单一环境变量切换备份或恢复模式，自动管理备份文件生命周期，平衡数据安全性与存储占用。

核心功能与特性

• 备份与恢复双模式：支持通过MODE环境变量切换备份（backup）或恢复（restore）操作
• 智能备份策略：
  • 自动区分每日备份（daily-*）和每小时备份（hourly-*）
  • 每日备份：保留指定天数内的备份文件，自动清理过期文件
  • 每小时备份：保留指定数量的最近备份文件，避免过多存储
• 灵活存储选项：支持本地文件系统或S3对象存储备份文件
• 环境变量配置：通过环境变量自定义备份保留策略、数据库连接信息等关键参数

备份策略详解

备份文件生成规则

• 检查输出目录中是否存在当天创建的备份文件：
  • 不存在：创建每日备份（文件名以daily-开头）
  • 存在：创建每小时备份（文件名以hourly-开头）

备份文件清理规则

• 每日备份：删除超过MAX_DAILY_BACKUP_AGE天的所有每日备份文件
• 每小时备份：仅保留MAX_HOURLY_BACKUP_COUNT个最近的每小时备份文件

此策略确保既保留近期备份（每小时），又维护历史备份（每日），同时避免存储冗余。

配置变量

通过以下环境变量配置脚本行为：

使用示例

本地文件系统备份与恢复

创建备份

bash
# 创建备份，脚本会自动创建名为`latest`的链接指向最新备份
docker run -it --rm \
  -e "MODE=backup" \
  -e "DATABASE_DSN=mysql://user:password@host.docker.internal:3306/mydb" \
  -v "$(pwd)/backups:/backup" \
  docker.xuanyuan.run/brainbitsgmbh/mariadb-backup:latest

恢复备份

bash
# 恢复`latest`备份（默认恢复最新备份）
docker run -it --rm \
  -e "MODE=restore" \
  -e "DATABASE_DSN=mysql://user:password@host.docker.internal:3306/mydb" \
  -v "$(pwd)/backups:/backup" \
  docker.xuanyuan.run/brainbitsgmbh/mariadb-backup:latest

使用S3存储备份

bash
# 使用S3存储备份（需配置AWS认证）
docker run -it --rm \
  -e "MODE=backup" \
  -e "DATABASE_DSN=mysql://user:password@db-host:3306/mydb" \
  -e "S3_BUCKET=my-backup-bucket" \
  -e "S3_BACKUP_PATH=mariadb/backups" \
  -e "AWS_ACCESS_KEY_ID=AKIAEXAMPLE" \
  -e "AWS_SECRET_ACCESS_KEY=secret" \
  docker.xuanyuan.run/brainbitsgmbh/mariadb-backup:latest

S3认证配置

脚本通过AWS CLI与S3交互，支持以下认证方式：

1. 本地AWS配置挂载：将本地已认证的AWS配置挂载到容器

   bash
   -v ~/.aws:/root/.aws
   

2. Kubernetes环境：在AWS EKS集群中，可通过为Pod配置IAM角色实现认证，无需额外密钥

3. 环境变量认证：直接传递AWS访问密钥

   bash
   -e "AWS_ACCESS_KEY_ID=你的访问密钥ID" \
   -e "AWS_SECRET_ACCESS_KEY=你的密钥"
   

故障排除

数据库连接失败

• 确保DATABASE_DSN格式正确（mysql://user:password@host:port/dbname）
• 容器内无法通过localhost访问宿主机数据库，本地测试时建议使用host.docker.internal（Docker Desktop）或宿主机IP
• 验证数据库用户权限（需有备份/恢复所需权限，如SELECT、LOCK TABLES等）
• 检查网络连通性，确保数据库端口在容器内可访问（可通过docker exec -it <容器ID> telnet <数据库主机> <端口>测试）