lgatica/mongorestore-s3

mongorestore-s3

http://dockeri.co/image/lgatica/mongorestore-s3](https://hub.docker.com/r/lgatica/mongorestore-s3/)

https://travis-ci.org/lgaticaq/mongorestore-s3.svg?branch=master](https://travis-ci.org/lgaticaq/mongorestore-s3)

基于Alpine Linux的Docker镜像，集成mongorestore和awscli工具，用于从AWS S3存储恢复MongoDB备份数据。

镜像概述

本镜像以轻量级Alpine Linux为基础，预装mongorestore（MongoDB数据恢复工具）和awscli（AWS命令行工具），旨在简化从AWS S3存储恢复MongoDB备份的流程，支持灵活的恢复配置。

核心功能

1. 从AWS S3存储下载指定的MongoDB备份文件
2. 恢复整个MongoDB数据库或指定集合
3. 支持添加额外的mongorestore参数（如--noIndexRestore）
4. 可配置S3存储路径和AWS访问凭证

使用场景

• MongoDB数据库灾难恢复
• 定期备份数据的验证与恢复测试
• 跨环境的数据迁移（从S3备份恢复到目标MongoDB实例）

配置说明

环境变量

• BACKUP_NAMES: 需恢复的S3备份文件名（如2016-09-20_06-00-00_UTC.gz）
• 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: AWS S3存储桶名称
• COLLECTIONS: 需恢复的指定集合（多个用逗号分隔，可选）
• EXTRA: mongorestore额外参数（可选）
• S3_PATH: S3存储桶内的备份路径（默认值：mongodb，格式：s3://bucket/path/）

部署示例

恢复整个数据库

bash
docker run -d --name mongorestore \
  -v /tmp/backup:/backup \
  -e "BACKUP_NAMES=2016-09-20_06-00-00_UTC.gz" \
  -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/mongorestore-s3

恢复指定集合

bash
docker run -d --name mongorestore \
  -v /tmp/backup:/backup \
  -e "BACKUP_NAMES=2016-09-20_06-00-00_UTC.gz" \
  -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 "COLLECTIONS=collection1,collection2" \
  docker.xuanyuan.run/lgatica/mongorestore-s3

带额外参数恢复

bash
docker run -d --name mongorestore \
  -v /tmp/backup:/backup \
  -e "BACKUP_NAMES=2016-09-20_06-00-00_UTC.gz" \
  -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 EXTRA="--noIndexRestore" \
  docker.xuanyuan.run/lgatica/mongorestore-s3

IAM政策配置

需为AWS用户配置以下政策（替换your_bucket为实际存储桶名称）：

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

许可证

MIT