Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/oefenweb/ansible-mydumper-backup
Ansible role to perform backups using mydumper
https://github.com/oefenweb/ansible-mydumper-backup
ansible backup backup-database database debian mydumper myloader mysql restore ubuntu
Last synced: 2 months ago
JSON representation
Ansible role to perform backups using mydumper
- Host: GitHub
- URL: https://github.com/oefenweb/ansible-mydumper-backup
- Owner: Oefenweb
- License: mit
- Created: 2015-05-11T12:00:49.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2024-03-11T10:20:47.000Z (11 months ago)
- Last Synced: 2024-03-11T11:36:17.435Z (11 months ago)
- Topics: ansible, backup, backup-database, database, debian, mydumper, myloader, mysql, restore, ubuntu
- Language: Shell
- Size: 111 KB
- Stars: 4
- Watchers: 3
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
## mydumper-backup
[](https://github.com/Oefenweb/ansible-mydumper-backup/actions?query=workflow%3ACI)
[](https://galaxy.ansible.com/Oefenweb/mydumper_backup)
Perform backups using [mydumper](https://launchpad.net/mydumper).
#### Requirements
* `mydumper` (will not be installed)
#### Variables
* `mydumper_backup_install_path`: [default: `/usr/local/bin`]: Install directory
* `mydumper_backup_mydumper_path`: [default: `/usr/local/bin`]: Path to `mydumper`
* `mydumper_backup_myloader_path`: [default: `mydumper_backup_mydumper_path`]: Path to `myloader`
* `mydumper_backup_all`: [optional, default: `false`]: Whether or not to backup all databases. When true, disables databases options
* `mydumper_backup_all_regex`: [optional]: A regular expression to match against database and table (only when `mydumper_backup_all` is true)
* `mydumper_backup_backup_databases`: [default: `[]`]: Backup declarations
* `mydumper_backup_backup_databases.{n}.src`: [required]: Database name (from)
* `mydumper_backup_backup_databases.{n}.dest`: [optional, default `src`]: Directory name (to)
* `mydumper_backup_restore_all`: [optional, default: `mydumper_backup_all`]: Whether or not to restore all databases. When true, disables databases options
* `mydumper_backup_restore_databases`: [default: `mydumper_backup_backup_databases`]: Restore declarations
* `mydumper_backup_restore_databases.{n}.src`: [required]: Database name (to)
* `mydumper_backup_restore_databases.{n}.dest`: [optional, default `src`]: Directory name (from)
* `mydumper_backup_restore_databases.{n}.overwrite_tables`: [optional, default `mydumper_backup_overwrite_tables`]: Drop any existing tables when restoring schemas
* `mydumper_backup_backup_path`: [default: `/tmp`]: Directory to backup to
* `mydumper_backup_restore_path`: [default: `mydumper_backup_backup_path`]: Directory to restore from
* `mydumper_backup_backup_threads`: [optional, default: `4`]: Number of threads to use for backup (e.g. `"{{ (ansible_processor_vcpus / 2) | round(0, 'ceil') }}"`)
* `mydumper_backup_restore_threads`: [optional, default: `mydumper_backup_backup_threads`]: Number of threads to use for restore
* `mydumper_backup_host`: [optional, default `localhost`]: The host to connect to
* `mydumper_backup_user`: [optional]: User with privileges to run the dump
* `mydumper_backup_password`: [optional]: User password
* `mydumper_backup_verbose`: [optional, default: `2`]: The verbosity of messages (e.g. `0 = silent`, `1 = errors`, `2 = warnings`, `3 = info`)
* `mydumper_backup_compress`: [optional, default: `false`]: Compress output files
* `mydumper_backup_build_empty_files`: [optional, default: `false`]: Build dump files even if no data available from table
* `mydumper_backup_triggers`: [optional, default: `false`]: Whether or not to dump triggers
* `mydumper_backup_overwrite_tables`: [optional, default: `false`]: Drop any existing tables when restoring schemas
* `mydumper_backup_enable_binlog`: [optional, default: `false`]: Log the data loading in the MySQL binary log if enabled
## Dependencies
None
## Recommended
* `ansible-mydumper` ([see](https://github.com/Oefenweb/ansible-mydumper))
#### Example(s)
##### Simple (all)
* Backup all databases
* Restore all databases
```yaml
---
- hosts: all
roles:
- oefenweb.mydumper-backup
vars:
mydumper_backup_all: true
mydumper_backup_overwrite_tables: true
```
##### Simple (all with ignore)
* Backup all databases ignore `sakila`
* Restore all databases
```yaml
---
- hosts: all
roles:
- oefenweb.mydumper-backup
vars:
mydumper_backup_all: true
mydumper_backup_all_regex: '^(?!(sakila\.))'
```
##### Simple (same src and dest)
* Backup database `sakila` to directory `sakila`
* Restore database `sakila` from directory `sakila`
```yaml
---
- hosts: all
roles:
- oefenweb.mydumper-backup
vars:
mydumper_backup_backup_databases:
- src: sakila
mydumper_backup_overwrite_tables: true
```
##### Simple (different src and dest)
* Backup database `sakila` to directory `alikas`
* Restore database `sakila` from directory `alikas`
```yaml
---
- hosts: all
roles:
- oefenweb.mydumper-backup
vars:
mydumper_backup_backup_databases:
- src: sakila
dest: alikas
mydumper_backup_overwrite_tables: true
```
##### Advance (different configuration for backup and restore and different src and dest)
* Backup database `a` to directory `b`
* Restore database `c` from directory `d`
```yaml
---
- hosts: all
roles:
- oefenweb.mydumper-backup
vars:
mydumper_backup_backup_databases:
- src: a
dest: b
mydumper_backup_restore_databases:
- src: c
dest: d
mydumper_backup_overwrite_tables: true
```
#### License
MIT
#### Author Information
Mischa ter Smitten
#### Feedback, bug-reports, requests, ...
Are [welcome](https://github.com/Oefenweb/ansible-mydumper-backup/issues)!