adomaceo/mc-mongodb-tools

Docker image MinIO Client MongoDB Tools for restore backup file from Amazon S3 compatible cloud storage service.

mc-mongodb-tools

MinIO Client Mongo DB Tools

This image use MinIO Client and mongodb-tools and have some uses:

• list: List the files in Amazon S3 compatible cloud storage service (AWS Signature v2 and v4) like Digitalocean Space or Google Storage
• restore: Get a mongoDB backup file from Amazon S3 compatible cloud storage service and restore to mongoDB server.

Usage

docker run -d \
  --env AWS_ACCESS_KEY_ID=awsaccesskeyid \
  --env AWS_SECRET_ACCESS_KEY=awssecretaccesskey \
  --env S3_ENDPOINT=https://nyc3.digitaloceanspaces.com
  --env S3_BUCKET_PATH=mybucket/backup \
  --link my_mongo_db:mongo \
  amaceog/mc-mongodb-tools list

List the files in the bucket mybucket and folder /backup.

docker run -d \
  --env AWS_ACCESS_KEY_ID=awsaccesskeyid \
  --env AWS_SECRET_ACCESS_KEY=awssecretaccesskey \
  --env S3_ENDPOINT=https://nyc3.digitaloceanspaces.com
  --env S3_BUCKET_PATH=mybucket/backup \
  --link my_mongo_db:mongo \
  amaceog/mc-mongodb-tools restore

Restore the latest.gz mongoDB backup file in bucket mybucket and folder /backup to my_mongo_db container.

Environment Variables

This image uses several environment variables and some are required.

AWS_ACCESS_KEY_ID

This environment variable is required for you to use this image. This environment variable specifies an AWS access key with permission to Amazon S3 compatible cloud storage service.

AWS_SECRET_ACCESS_KEY

This environment variable is required for you to use this image. This environment variable specifies the secret key associated with the access key.

API_SIGNATURE

This environment variable is optional for you to use this image. By default, it is set to "S3v4". Valid options are '[S3v4, S3v2]'

S3_ENDPOINT

This environment variable is required for you to use this image and specifies MinIO server displays URL.

• By default, it is set to https://s3.amazonaws.com for Amazon S3.
• For Google Cloud Storage use: https://storage.googleapis.com
• For Digitalocean Space in nyc3 region use http://nyc3.digitaloceanspaces.com

S3_BUCKET_PATH

This environment variable is required for you to use this image. This environment variable specifies the bucket name and path.

MONGO_HOST

This environment variable is required in restore mode. This environment variable specifies the mongo host. By default, it is set to mongo

MONGO_DATABASE

This environment variable is optional for you to use this image. This environment variable specifies the mongoDB database name.

MONGO_RESTORE_OPTS

This environment variable is optional for you to use this image. This environment variable specifies the mongoDB restore options.

FILE

This environment variable is optional for you to use this image. This environment variable specifies the backup file to restore. By default, it is set to latest.gz