Skip to content

Simple backup utility to dump Mysql backups to S3 and Google Cloud Storage (GCS)

Notifications You must be signed in to change notification settings

newera-systems/mysql-backup-to-s3

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

mysql-backup-to-s3

Back up mysql databases to... S3!

Docker image

https://hub.docker.com/repository/docker/newerasystems/mysql-backup-to-s3

Overview

mysql-backup is a simple way to do MySQL database backups when the database is running in a container.

It has the following features:

  • dump to S3 and Google Cloud Storage
  • select database user and password
  • connect to any container running on the same system

Please see CONTRIBUTORS.md for a list of contributors.

This utility is a stripped down version of mysql-backup

Backup

To run a backup, launch mysql-backup image as a container with the correct parameters. Everything is controlled by environment variables passed to the container.

For example:

docker run -d --restart=always  -e DB_DUMP_TARGET=s3://my-bucket/  -e AWS_ACCESS_KEY_ID=my-aws-key -e AWS_SECRET_ACCESS_KEY=my-aws-secret  -e DB_SERVER=my-db-container databack/mysql-backup

The above will run a dump every 60 minutes, beginning at the next 2330 local time, from the database accessible in the container my-db-container.

The following are the environment variables for a backup:

You should consider the use of --env-file=, docker secrets to keep your secrets out of your shell history

  • DB_SERVER: hostname to connect to database. Required.
  • DB_PORT: port to use to connect to database. Optional, defaults to 3306
  • DB_USER: username for the database
  • DB_PASS: password for the database
  • DB_DUMP_DEBUG: If set to true, print copious shell script messages to the container log. Otherwise only basic messages are printed.
  • DB_DUMP_TARGET: Where to put the dump file, should be a directory.
    • S3: If the value of DB_DUMP_TARGET is a URL of the format s3://bucketname/path then it will connect via awscli.
  • AWS_ACCESS_KEY_ID: AWS Key ID
  • AWS_SECRET_ACCESS_KEY: AWS Secret Access Key
  • AWS_DEFAULT_REGION: Region in which the bucket resides
  • AWS_ENDPOINT_URL: Specify an alternative endpoint for s3 interopable systems e.g. Digitalocean
  • MYSQLDUMP_OPTS: A string of options to pass to mysqldump, e.g. MYSQLDUMP_OPTS="--opt abc --param def --max_allowed_packet=123455678" will run mysqldump --opt abc --param def --max_allowed_packet=123455678

Permissions

By default, the backup/restore process does not run as root (UID O). Whenever possible, you should run processes (not just in containers) as users other than root. In this case, it runs as username appuser with UID/GID 1005.

Database Container

In order to perform the actual dump, mysql-backup needs to connect to the database container. You must pass the database hostname - which can be another container or any database process accessible from the backup container - by passing the environment variable DB_SERVER with the hostname or IP address of the database. You may override the default port of 3306 by passing the environment variable DB_PORT.

docker run -d --restart=always -e DB_USER=user123 -e DB_PASS=pass123 -e DB_DUMP_TARGET=s3://my-bucket -e DB_SERVER=my-db-container

Dump Target

The dump target is where you want the backup files to be saved. The backup file always is a compressed file the following format:

YYYYMMDD_HHmm_db_name_.sql.tar.gz

Where:

  • YYYY = year in 4 digits
  • MM = month number from 01-12
  • DD = date for 01-31
  • HH = hour from 00-23
  • mm = minute from 00-59

The time used is UTC time at the moment the dump begins.

You'll need to specify your AWS credentials and default AWS region via AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY and AWS_DEFAULT_REGION

DigitalOcean

Also note that if you are using an s3 interopable storage system like DigitalOcean you can use that as the target by setting AWS_ENDPOINT_URL to ${REGION_NAME}.digitaloceanspaces.com and setting DB_DUMP_TARGET to s3://bucketname/path.

Google Cloud Storage

You can upload your backups directly to Google Cloud Storage. You will need to set the following options:

AWS_ENDPOINT_OPT=--disable-multipart
AWS_ENDPOINT_URL=https://storage.googleapis.com

Running a CronJob inside Kubernetes

This is a sample CronJob that should get you started quickly on k8s to backup directly on a bucket on GCS

apiVersion: batch/v1beta1
kind: CronJob
metadata:
  name: mysql-backup-to-s3
  namespace: default
spec:
  concurrencyPolicy: Forbid
  failedJobsHistoryLimit: 21
  jobTemplate:
    spec:
      template:
        spec:
          containers:
          - env:
            - name: DB_SERVER
              value: mysql.default.svc.cluster.local
            - name: DB_USER
              value: backup-user
            - name: DB_PASS
              valueFrom:
                secretKeyRef:
                  key: mariadb-password
                  name: mariadb
            - name: AWS_ACCESS_KEY_ID
              valueFrom:
                secretKeyRef:
                  key: aws-key
                  name: mysql-backup-auth
            - name: AWS_SECRET_ACCESS_KEY
              valueFrom:
                secretKeyRef:
                  key: aws-secret
                  name: mysql-backup-auth
            - name: DB_DUMP_TARGET
              value: s3://my-bucket
            - name: COMPRESSION
              value: gzip
            - name: AWS_ENDPOINT_OPT
              value: --disable-multipart
            - name: AWS_ENDPOINT_URL
              value: https://storage.googleapis.com
            image: newerasystems/mysql-backup-to-s3:latest
            imagePullPolicy: Always
            name: mysql-backup-to-s3
            resources: {}
            terminationMessagePath: /dev/termination-log
            terminationMessagePolicy: File
          dnsPolicy: ClusterFirst
          restartPolicy: Never
          schedulerName: default-scheduler
          securityContext: {}
          terminationGracePeriodSeconds: 30
  schedule: 5 6 * * *
  successfulJobsHistoryLimit: 3
  suspend: false

License

Released under the MIT License.