wetransform/dockup-mongo

dockup-mongo

镜像概述

用于将MongoDB数据库备份到AWS S3或从AWS S3恢复的Docker镜像。基于https://github.com/wetransform-os/dockup%E6%9E%84%E5%BB%BA%EF%BC%8C%E9%80%9A%E8%BF%87%60mongodump%60%E5%88%9B%E5%BB%BA%E6%95%B0%E6%8D%AE%E5%BA%93%E8%BD%AC%E5%82%A8%E5%B9%B6%E5%88%A9%E7%94%A8dockup%E5%AE%9E%E7%8E%B0%E5%A4%87%E4%BB%BD/%E6%81%A2%E5%A4%8D%E6%B5%81%E7%A8%8B%E3%80%82

核心功能与特性

• 使用mongodump工具生成MongoDB数据库转储文件
• 支持将备份文件存储到AWS S3或从AWS S3恢复数据
• 提供MongoDB专用配置选项，适配不同数据库环境（主机、端口、认证信息等）
• 基于dockup实现备份/恢复核心逻辑，并集成MongoDB特有处理流程
• 支持扩展功能（如GnuPG加密配置），需参考dockup仓库文档

配置说明

MongoDB专用环境变量

容器链接与网络配置

通常需将MongoDB容器链接到dockup容器，推荐使用--link mongodb:mongodb参数。若链接名称为mongodb，可直接使用默认MONGODB_HOST配置，无需额外修改。

测试与验证

备份/恢复功能可通过./test-backup.sh脚本验证。运行前需准备test-env.txt配置文件（参考test-env.txt.sample模板），包含必要的AWS S3认证信息及MongoDB连接参数。

禁止覆盖的环境变量

使用MongoDB专用镜像时，以下dockup原生环境变量禁止手动覆盖，否则会破坏MongoDB备份/恢复流程：

• BEFORE_BACKUP_CMD
• AFTER_BACKUP_CMD
• AFTER_RESTORE_CMD
• PATHS_TO_BACKUP

扩展配置参考

有关加密配置、备份策略（如定时备份）等高级功能，需参考https://github.com/wetransform-os/dockup%E6%96%87%E6%A1%A3%E3%80%82

使用示例

基本备份命令示例

bash
docker run -d \
  --link mongodb:mongodb \
  -e "AWS_ACCESS_KEY_ID=your_aws_key" \
  -e "AWS_SECRET_ACCESS_KEY=your_aws_secret" \
  -e "AWS_REGION=us-east-1" \
  -e "S3_BUCKET=your-backup-bucket" \
  -e "MONGODB_USER=admin" \
  -e "MONGODB_PASS=your_mongo_password" \
  -e "MONGODB_DB=target_db" \
  wetransform/dockup-mongo

关键参数说明

• AWS_ACCESS_KEY_ID/AWS_SECRET_ACCESS_KEY：AWS S3访问凭证（必填）
• AWS_REGION：S3存储桶所在区域（必填）
• S3_BUCKET：目标备份存储桶名称（必填）
• MongoDB相关参数根据实际数据库环境调整