andrecosta / mysql-backup-s3

Backup and restore mysql db using aws s3 storage

Docker-full-mysql-backup-s3

Container to backup and restore your entire MySQL database, including all databases in your host, users, permissions... using awscli.

This is not a valid solution for big databases. It will work fine for small applications. It is thought to be used for a volatile mysql database (e.g. a mysql database run a docker inside a multicontainer that could reload from time to time, more info.

Container startup explained

• This container user cron to make backups

• Mysql will dump the database to this container and compress it using gzip

• Using s3cli the file will be uploaded to S3 Storage.

• To run a manual backup just enter the container and run:

  ./backup

This will create a file in you bucket that will look like default-2015-08-03_17-58.sql.gz. It will also create a copy of this file called last.sql.gz. So we can reference always the very last backup in a very easy way.

• To restore a db just enter the container and run the 'restore' script with the file name to restore:

  ./restore example.sql.gz

This action should be only done on a freshly created database with root user. This will re-create all the users that were previously there, recreate all the databases and all the data.

Environment variables

• $MYSQL_PASSWORD - The password to connect with Mysql.
• $MYSQL_USER - The username to connect with Mysql.
• $AWS_ACCESS_KEY_ID - Aws acess key.
• $AWS_SECRET_ACCESS_KEY -Aws secret key.
• $BUCKET - Aws bucket name .
• $REGION - Aws region where your bucket is.
• $MYSQL_PORT - Port to connect with Mysql.
• $MYSQL_HOST - Host where mysql is running.
• $FILENAME - Name to file in S3 Storage. Default name default-date +"%Y-%m-%d_%H-%M" output example default-2015-08-03_17-58
• $BACKUP_WINDOW - What time should backup run. you should use crontab format, so see [documentation](http://www.freebsd.org/cgi/man.cgi?crontab(5). default value every day at 6 am.
• $KILL_IF_ANY_FAIL - If any error occurs while the backing up proccess, we will kill the docker container will be finished
• $RESTORE_ON_START - Restores last.sql.gz, at the moment of start the docker container

Example of running

docker run --rm --name mysql-backup \
  --env AWS_ACCESS_KEY_ID=--your-aws-access-key-- \
  --env AWS_SECRET_ACCESS_KEY=--your-aws-secret-key-- \
  --env BUCKET=backups.example.com \
  --env REGION=eu-west-1  \
  --env FILENAME=backup \
  --env MYSQL_HOST=test.mysql.net \
  --env MYSQL_USER=root \
  --env MYSQL_PASSWORD=password \
  --env BACKUP_WINDOW='0 6 * * *' \
  alvarohurtado84/docker-full-mysql-backup-s3

This will upload to Aws S3 a file named backup-2015-08-04_09-47.sql.gz everyday at 6am.

Building image

docker build -t alvarohurtado84/docker-full-mysql-backup-s3 .