datamini/mongo-vault repository overview

⁠MongoVault——带有自动备份和恢复功能的MongoDB

本文档介绍如何使用 datamini/mongo-vault 运行 MongoDB 数据库进行自动备份和恢复。备份文件支持保存在Cloud Storage中，目前支持阿里云OSS。

优势：

1. 省钱。阿里云上最便宜的MongoDB，一个月要1800元。
2. 省事。Docker运行MongoDB简单，但数据没备份心慌慌。这个镜像可以自动帮你完成备份，只需要设置备份的频率、OSS的Bucket即可。
3. 功能虽然谈不上丰富，但简单、完整、够用。数据库和备份恢复工具集成到一个镜像里。 您可以：
   • 拉起MongoDB实例的时候开启自动备份
   • 拉起MongoDB实例的时候按照要求恢复数据
   • 拉起MongoDB实例的时候先恢复数据，同时开启自动备份
   • 随时手动查看备份的文件列表（进入容器）
   • 随时手动恢复数据（进入容器）

该镜像基于 mongo:5.0.22。

⁠QuickStart

1. 运行一个可以自动备份的MongoDB实例

   docker run -d \
     -e ENABLE_MONGO_VAULT_BACKUP=true \
     -e MONGO_VAULT_OSS_AK=LTAENx0nrenExlYsTspz2 \
     -e MONGO_VAULT_OSS_SK=nFewnENWONDssofnwen1oX \
     -e MONGO_VAULT_OSS_ENDPOINT=oss-cn-shenzhen-internal.aliyuncs.com \
     datamini/mongo-vault
   

   Copy

2. 查看备份列表

   进入MongoDB所在的容器执行命令mongo_vault_list_backup进行查看。

   docker exec -it mongo_vault_instance mongo_vault_list_backup
   

   Copy

3. 使用最新的备份恢复出来一个新的MongoDB实例

   docker run -d \
     -e ENABLE_MONGO_VAULT_RESTORE=true \
     -e MONGO_VAULT_OSS_AK=LTAENx0nrenExlYsTspz2 \
     -e MONGO_VAULT_OSS_SK=nFewnENWONDssofnwen1oX \
     -e MONGO_VAULT_OSS_ENDPOINT=oss-cn-shenzhen-internal.aliyuncs.com \
     datamini/mongo-vault
   

   Copy

4. 将 db1 的最新备份恢复到一个正在运行的MongoDB中，并改名为 newdb1

   docker exec -it mongo_vault_instance mongo_vault_restore --databases=db1:newdb1
   

   Copy

   这里，--databases 同环境变量 MONGO_VAULT_RESTORE_DATABASES，且优先级更高。

⁠容器参数

启动容器的Env参数列表如下：

注意事项

• 备份时，请根据实际需求调整 MONGO_VAULT_BACKUP_DATABASES 和 MONGO_VAULT_BACKUP_SCHEDULE
• 恢复时，请确认是恢复出一个新的实例，还是将数据恢复到现有实例中的新的DB

⁠容器内的脚本

进入容器后，也可以手动执行下面三个命令：

• mongo_vault_backup：手动备份
• mongo_vault_list_backup：查看备份列表
• mongo_vault_restore：手动恢复

⁠示例

使用最新的备份恢复出来一个新的MongoDB实例，并开启自动备份

docker run -d \
  --name mongodb_restored \
  -e MONGO_INITDB_ROOT_USERNAME=admin \
  -e MONGO_INITDB_ROOT_PASSWORD=1234 \
  -e ENABLE_MONGO_VAULT_BACKUP=true \
  -e MONGO_VAULT_BACKUP_DATABASES="db1,db2" \
  -e MONGO_VAULT_BACKUP_SCHEDULE="0 3 * * *" \
  -e ENABLE_MONGO_VAULT_RESTORE=true \
  -e MONGO_VAULT_RESTORE_DATABASES="db1,db2" \
  -e MONGO_VAULT_OSS_AK=LTAENx0nrenExlYsTspz2 \
  -e MONGO_VAULT_OSS_SK=nFewnENWONDssofnwen1oX \
  -e MONGO_VAULT_OSS_ENDPOINT=oss-cn-shenzhen-internal.aliyuncs.com \
  -e MONGO_VAULT_OSS_BUCKET=mongo_backups \
  -e MONGO_VAULT_OSS_URI_PREFIX=my_user_db_prod \
  datamini/mongo-vault

或者使用如下的 docker-compose.yml 文件运行：

services:
  mongodb_restored:
    image: datamini/mongo-vault
    environment:
      MONGO_INITDB_ROOT_USERNAME: admin
      MONGO_INITDB_ROOT_PASSWORD: 1234
      ENABLE_MONGO_VAULT_BACKUP: "true"
      MONGO_VAULT_BACKUP_DATABASES: db1,db2
      MONGO_VAULT_BACKUP_SCHEDULE: "0 3 * * *"
      ENABLE_MONGO_VAULT_RESTORE: "true"
      MONGO_VAULT_RESTORE_DATABASES: db1,db2
      MONGO_VAULT_OSS_AK: LTAENx0nrenExlYsTspz2
      MONGO_VAULT_OSS_SK: nFewnENWONDssofnwen1oX
      MONGO_VAULT_OSS_ENDPOINT: oss-cn-shenzhen-internal.aliyuncs.com
      MONGO_VAULT_OSS_BUCKET: mongo_backups
      MONGO_VAULT_OSS_URI_PREFIX: my_user_db_prod