lgatica/mongodump-s3

mongodump-s3

基于Alpine Linux的Docker镜像，集成mongodump和awscli工具，用于将Mongo数据库备份到AWS S3存储服务。

镜像概述

本镜像基于轻量级Alpine Linux构建，包含mongodump工具（用于导出MongoDB数据）和AWS CLI（用于与AWS S3交互），提供简单高效的MongoDB备份解决方案，支持周期性自动备份和即时备份，可灵活配置备份策略。

核心功能

1. 周期性备份：通过cron表达式设置定时备份计划。
2. 即时备份：无需定时，直接执行一次备份操作。
3. 全库备份：支持备份整个MongoDB实例（而非单个数据库）。
4. 本地备份保留：可配置保留指定数量的本地备份文件。
5. S3存储：将备份文件上传至AWS S3桶，确保数据安全。

使用场景

• 日常MongoDB数据定期备份需求。
• 灾难恢复准备，确保数据可恢复。
• 需要将MongoDB数据存储到云端的场景。

配置说明

环境变量

• MONGO_URI：MongoDB连接地址（必填，格式如mongodb://user:pass@host:port/dbname）。
• AWS_ACCESS_KEY_ID：AWS访问密钥ID（必填）。
• AWS_SECRET_ACCESS_KEY：AWS秘密访问密钥（必填）。
• AWS_DEFAULT_REGION：AWS区域（必填，如us-west-1）。
• S3_BUCKET：目标S3桶名称（必填）。
• BACKUP_CRON_SCHEDULE：备份定时表达式（如0 2 * * *表示每天2点执行）。
• MONGO_COMPLETE：是否全库备份（设置为true启用）。
• MAX_BACKUPS：保留本地备份文件数量（需挂载本地目录到/backup）。
• S3_PATH：S3存储路径（默认值mongodb，即备份文件存储在your_bucket/mongodb下）。

Docker部署示例

周期性备份（每天2点执行）

bash
docker run -d --name mongodump \
  -e "MONGO_URI=mongodb://user:pass@host:port/dbname" \
  -e "AWS_ACCESS_KEY_ID=your_aws_access_key" \
  -e "AWS_SECRET_ACCESS_KEY=your_aws_secret_access_key" \
  -e "AWS_DEFAULT_REGION=us-west-1" \
  -e "S3_BUCKET=your_aws_bucket" \
  -e "BACKUP_CRON_SCHEDULE=0 2 * * *" \
  docker.xuanyuan.run/lgatica/mongodump-s3

周期性全库备份（每天2点执行）

bash
docker run -d --name mongodump \
  -e "MONGO_URI=mongodb://user:pass@host:port/dbname" \
  -e "AWS_ACCESS_KEY_ID=your_aws_access_key" \
  -e "AWS_SECRET_ACCESS_KEY=your_aws_secret_access_key" \
  -e "AWS_DEFAULT_REGION=us-west-1" \
  -e "S3_BUCKET=your_aws_bucket" \
  -e "BACKUP_CRON_SCHEDULE=0 2 * * *" \
  -e "MONGO_COMPLETE=true" \
  docker.xuanyuan.run/lgatica/mongodump-s3

周期性全库备份并保留最近5个本地备份

bash
docker run -d --name mongodump \
  -v /tmp/backup:/backup \
  -e "MONGO_URI=mongodb://user:pass@host:port/dbname" \
  -e "AWS_ACCESS_KEY_ID=your_aws_access_key" \
  -e "AWS_SECRET_ACCESS_KEY=your_aws_secret_access_key" \
  -e "AWS_DEFAULT_REGION=us-west-1" \
  -e "S3_BUCKET=your_aws_bucket" \
  -e "BACKUP_CRON_SCHEDULE=0 2 * * *" \
  -e "MONGO_COMPLETE=true" \
  -e "MAX_BACKUPS=5" \
  docker.xuanyuan.run/lgatica/mongodump-s3

即时备份

bash
docker run -d --name mongodump \
  -e "MONGO_URI=mongodb://user:pass@host:port/dbname" \
  -e "AWS_ACCESS_KEY_ID=your_aws_access_key" \
  -e "AWS_SECRET_ACCESS_KEY=your_aws_secret_access_key" \
  -e "AWS_DEFAULT_REGION=us-west-1" \
  -e "S3_BUCKET=your_aws_bucket" \
  docker.xuanyuan.run/lgatica/mongodump-s3

IAM政策配置

需为AWS用户分配以下权限（替换your_bucket为实际桶名称）：

xml
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "Stmt1412062044000",
            "Effect": "Allow",
            "Action": [
                "s3:PutObject",
                "s3:PutObjectAcl"
            ],
            "Resource": [
                "arn:aws:s3:::your_bucket/*"
            ]
        },
        {
            "Sid": "Stmt1412062128000",
            "Effect": "Allow",
            "Action": [
                "s3:ListBucket"
            ],
            "Resource": [
                "arn:aws:s3:::your_bucket"
            ]
        }
    ]
}

许可证

MIT