# MySQL Backup MySQL Backup tool, backup database to S3 or Object Storage [![Build](https://github.com/jkaninda/mysql-bkup/actions/workflows/build.yml/badge.svg)](https://github.com/jkaninda/mysql-bkup/actions/workflows/build.yml) ![Docker Image Size (latest by date)](https://img.shields.io/docker/image-size/jkaninda/mysql-bkup?style=flat-square) ![Docker Pulls](https://img.shields.io/docker/pulls/jkaninda/mysql-bkup?style=flat-square) > Run on: - Docker - Kubernetes > Links: - [Docker Hub](https://hub.docker.com/r/jkaninda/mysql-bkup) - [Github](https://github.com/jkaninda/mysql-bkup) > Postgres solution : - [Postgress](https://github.com/jkaninda/pg-bkup) ## Storage: - local - s3 - Object storage ## Usage | Options | Shorts | Usage | |---------------|--------|------------------------------------| | mysql_bkup | bkup | CLI utility | | --operation | -o | Set operation. backup or restore (default: backup) | | --storage | -s | Set storage. local or s3 (default: local) | | --file | -f | Set file name for restoration | | --path | | Set s3 path without file name. eg: /custom_path | | --dbname | -d | Set database name | | --port | -p | Set database port (default: 3306) | | --timeout | -t | Set timeout (default: 60s) | | --help | -h | Print this help message and exit | | --version | -V | Print version information and exit | ## Backup database : Simple backup usage ```sh bkup --operation backup --dbname database_name ``` ```sh bkup -o backup -d database_name ``` ### S3 ```sh bkup --operation backup --storage s3 --dbname database_name ``` ## Docker run: ```sh docker run --rm --network your_network_name --name mysql-bkup -v $PWD/backup:/backup/ -e "DB_HOST=database_host_name" -e "DB_USERNAME=username" -e "DB_PASSWORD=password" jkaninda/mysql-bkup:latest bkup -o backup -d database_name ``` ## Docker compose file: ```yaml version: '3' services: mariadb: container_name: mariadb image: mariadb environment: MYSQL_DATABASE: mariadb MYSQL_USER: mariadb MYSQL_PASSWORD: password MYSQL_ROOT_PASSWORD: password mysql-bkup: image: jkaninda/mysql-bkup container_name: mysql-bkup command: - /bin/sh - -c - bkup --operation backup -d database_name volumes: - ./backup:/backup environment: - DB_PORT=3306 - DB_HOST=mariadb - DB_USERNAME=mariadb - DB_PASSWORD=password ``` ## Restore database : Simple database restore operation usage ```sh bkup --operation restore --dbname database_name --file database_20231217_115621.sql ``` ```sh bkup -o restore -f database_20231217_115621.sql ``` ### S3 ```sh bkup --operation restore --storage s3 --file database_20231217_115621.sql ``` ## Docker run: ```sh docker run --rm --network your_network_name --name mysql-bkup -v $PWD/backup:/backup/ -e "DB_HOST=database_host_name" -e "DB_USERNAME=username" -e "DB_PASSWORD=password" jkaninda/mysql-bkup bkup -o backup -d database_name -f mydb_20231219_022941.sql.gz ``` ## Docker compose file: ```yaml version: '3' services: mariadb: container_name: mariadb image: mariadb:latest environment: MYSQL_DATABASE: mariadb MYSQL_USER: mariadb MYSQL_PASSWORD: password MYSQL_ROOT_PASSWORD: password mysql-bkup: image: jkaninda/mysql-bkup container_name: mysql-bkup command: - /bin/sh - -c - bkup --operation restore --file database_20231217_115621.sql --dbname database_name volumes: - ./backup:/backup environment: #- FILE_NAME=mariadb_20231217_040238.sql # Optional if file name is set from command - DB_PORT=3306 - DB_HOST=mariadb - DB_NAME=mariadb - DB_USERNAME=mariadb - DB_PASSWORD=password ``` ## Run ```sh docker-compose up -d ``` ## Backup to S3 ```sh docker run --rm --privileged --device /dev/fuse --name mysql-bkup -e "DB_HOST=db_hostname" -e "DB_USERNAME=username" -e "DB_PASSWORD=password" -e "ACCESS_KEY=your_access_key" -e "SECRET_KEY=your_secret_key" -e "BUCKETNAME=your_bucket_name" -e "S3_ENDPOINT=https://eu2.contabostorage.com" jkaninda/mysql-bkup bkup -o backup -s s3 -d database_name ``` > To change s3 backup path add this flag : --path myPath . default path is /mysql_bkup Simple S3 backup usage ```sh bkup --operation backup --storage s3 --dbname mydatabase ``` ```yaml mysql-bkup: image: jkaninda/mysql-bkup container_name: mysql-bkup tty: true privileged: true devices: - "/dev/fuse" command: - /bin/sh - -c - mysql_bkup --operation restore --storage s3 -f database_20231217_115621.sql.gz environment: - DB_PORT=3306 - DB_HOST=mysql - DB_NAME=mariadb - DB_USERNAME=mariadb - DB_PASSWORD=password - ACCESS_KEY=${ACCESS_KEY} - SECRET_KEY=${SECRET_KEY} - BUCKETNAME=${BUCKETNAME} - S3_ENDPOINT=${S3_ENDPOINT} ``` ## Run "docker run" from crontab Make an automated backup (every night at 1). > backup_script.sh ```sh #!/bin/sh DB_USERNAME='db_username' DB_PASSWORD='password' DB_HOST='db_hostname' DB_NAME='db_name' BACKUP_DIR='/some/path/backup/' docker run --rm --name mysql-bkup -v $BACKUP_DIR:/backup/ -e "DB_HOST=$DB_HOST" -e "DB_USERNAME=$DB_USERNAME" -e "DB_PASSWORD=$DB_PASSWORD" jkaninda/mysql-bkup:latest bkup -o backup -d $DB_NAME ``` ```sh chmod +x backup_script.sh ``` Your crontab looks like this: ```conf 0 1 * * * /path/to/backup_script.sh ``` ## Kubernetes CronJob Simple Kubernetes CronJob usage: ```yaml apiVersion: batch/v1 kind: CronJob metadata: name: mysql-bkup-job spec: schedule: "0 1 * * *" jobTemplate: spec: template: spec: backoffLimit: 2 containers: - name: mysql-bkup image: jkaninda/mysql-bkup securityContext: privileged: true command: - /bin/sh - -c - bkup -o backup -s s3 --path /custom_path env: - name: DB_PORT value: "3306" - name: DB_HOST value: "" - name: DB_NAME value: "" - name: DB_USERNAME value: "" # Please use secret! - name: DB_PASSWORD value: "password" - name: ACCESS_KEY value: "" - name: SECRET_KEY value: "" - name: BUCKETNAME value: "" - name: S3_ENDPOINT value: "https://s3.amazonaws.com" restartPolicy: Never ```