minback/mongo

minback-mongo

MongoDB的Minio备份容器

minback-mongo是一个轻量级Docker容器，用于通过mongodump工具将MongoDB数据库备份到Minio S3存储桶。其设计简洁，旨在通过简单配置实现数据库备份，并适合与Kubernetes CronJob结合，实现定期自动备份关键数据。

核心功能

• 支持将单个MongoDB数据库备份到S3存储桶
• 轻量级且生命周期短暂（执行备份后即退出）
• 实现简洁易懂，便于理解和维护

使用场景

• 需要定期备份MongoDB数据库的场景
• 希望将数据库备份存储到Minio S3存储的环境
• 需通过容器化方式实现简单、可配置的备份流程的场景，尤其是与Kubernetes CronJob结合实现定时自动备份

使用方法

基本命令格式

docker run [选项] minback/mongo DB_NAME [OPTIONS...]

参数说明

• DB_NAME: 要备份的数据库名称（必填）
• OPTIONS: 传递给mongodump的额外选项（如-h指定MongoDB主机、-p指定端口等）

部署示例

使用环境变量文件执行备份

sh
docker run --rm --env-file backup.env minback/mongo my_db -h mongoserver1

• --rm: 备份完成后自动删除容器
• --env-file backup.env: 指定包含Minio配置的环境变量文件
• my_db: 要备份的数据库名称
• -h mongoserver1: 传递给mongodump的选项，指定MongoDB主机为mongoserver1

环境变量文件示例（backup.env）

ini
# Minio服务器地址
MINIO_SERVER=https://play.minio.io/
# 访问Minio的Access Key
MINIO_ACCESS_KEY=minio
# 访问Minio的Secret Key
MINIO_SECRET_KEY=miniosecret
# 存储备份的Minio桶名称
MINIO_BUCKET=backups

配置说明

容器通过环境变量进行配置，支持手动启动或集成到Kubernetes配置框架中。

必要环境变量

MINIO_SERVER

• 描述：要发送备份的Minio服务器地址
• 示例：https://play.minio.io/

MINIO_ACCESS_KEY

• 描述：连接Minio服务器的Access Key
• 示例：minio

MINIO_SECRET_KEY

• 描述：连接Minio服务器的Secret Key
• 示例：miniosecret

MINIO_BUCKET

• 描述：存储备份文件的Minio桶名称
• 示例：backups

可选环境变量

DATE_FORMAT=+%Y-%m-%d

• 描述：备份文件名称中的日期格式，文件命名规则为$DB-$DATE.archive（其中$DB为数据库名称，$DATE为格式化后的日期）
• 默认值：+%Y-%m-%d（例如：数据库my_db在2024-05-20的备份文件名为my_db-2024-05-20.archive）

参考链接

• Kubernetes CronJob
• Minio