A little helper to create a backup of a mongodb using mongodump, storing the dump in azure blob or file storage using azcopy.
Modified to allow logging in into Azure via service credentials
Tools used:
Make sure you set the following environment variables, in .env
| variable | description |
|---|---|
| MONGO_URI | mongo host URI |
| MONGO_CONNECTIONSTRING | mongo host connection string |
| AZURE_SA | Azure Storage account name |
| AZURE_BLOB_CONTAINER | name of the azure storage blob container |
| AZURE_SHARE_NAME | name of the azure file share |
| AZURE_DESTINATION_KEY | azure storage account destination key |
| AZCOPY_SPA_CLIENT_SECRET | azure service client secret |
| AZURE_APP_ID | azure app id |
| AZURE_TENANT_ID | azure tenant id |
| DB | name of mongo database to backup |
| MONGO_USERNAME | username for mongodb |
| MONGO_PASSWORD | password to authenticate against mongodb |
| MONGO_AUTH_DB | name of mongo authentication database |
You should specify either AZURE_BLOB_CONTAINER for blob storage or AZURE_SHARE_NAME for a file share.
When the container starts it will connect to mongodb and execute the backup process. To override this behaviour change the entrypoint to cat in your compose file.
You can then exec into the container and start the backup with the ./backup_mongo.sh script.
Run the backup directly with docker run or by using the run.sh script as follows:
| argument | description |
|---|---|
| -u or --url | mongo host URI |
| --sa | Azure Storage account name |
| -c or --blob-container | name of the azure storage blob container |
| -s or --share-name | name of the azure file share |
| -k or --key | azure storage account destination key |
| --db | name of mongo database to backup |
| -n or --username | username for mongodb |
| -p or --password | password to authenticate against mongodb |
| -a or --auth-db | name of mongo authentication database |