public_git
/
ansible-role-mariadb-debian
mirror of https://github.com/fauust/ansible-role-mariadb.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

README copyedits

This commit is contained in:
Ian Gilfillan 2020-05-28 17:34:34 +02:00
parent c3d75cd4a3
commit 175bd0af6b
1 changed files with 10 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
README.md
View File

@ -4,18 +4,18 @@
Install and configure MariaDB Server on Debian/Ubuntu. Install and configure MariaDB Server on Debian/Ubuntu.
Optionally, this role also permits to: Optionally, this role also permits one to:
- deploy a master/slave cluster; - deploy a master/slave cluster;
- setup backups and rotation of the dumps. - setup backups and rotation of the dumps.
## Requirements ## Requirements
The role use The role uses
[`mysql_user`](https://docs.ansible.com/ansible/latest/modules/mysql_user_module.html) [`mysql_user`](https://docs.ansible.com/ansible/latest/modules/mysql_user_module.html)
and and
[`mysql_db`](https://docs.ansible.com/ansible/latest/modules/mysql_db_module.html) [`mysql_db`](https://docs.ansible.com/ansible/latest/modules/mysql_db_module.html)
ansible modules that depends on [PyMySQL](https://github.com/PyMySQL/PyMySQL) so ansible modules that depend on [PyMySQL](https://github.com/PyMySQL/PyMySQL) so
Python 2.7 or Python 3.X versions are needed. Python 2.7 or Python 3.X versions are needed.
For older Python versions, you may use For older Python versions, you may use
@ -56,7 +56,7 @@ mariadb_can_restart: true
``` ```
**Warning:** you may consider setting `mariadb_can_restart` to `false` on **Warning:** you may consider setting `mariadb_can_restart` to `false` on
production systems to prevent ansible runs to restart the MariaDB Server. production systems to prevent ansible runs from restarting the MariaDB Server.
### General configuration ### General configuration
@ -64,7 +64,7 @@ To populate the MariaDB Server configuration file, we use almost only raw
variables. This permits more flexibility and a very simple variables. This permits more flexibility and a very simple
[`templates/my.cnf.j2`](./templates/my.cnf.j2) file. [`templates/my.cnf.j2`](./templates/my.cnf.j2) file.
By default, some common and standard options are deployed based on MariaDB By default, some common and standard options are deployed based on the MariaDB
Foundation package and it should be easy to change them all (see Foundation package and it should be easy to change them all (see
[`my.cnf`](./my.cnf)). [`my.cnf`](./my.cnf)).
@ -147,7 +147,7 @@ mariadb_mysqldump_raw: |
max_allowed_packet = 16M max_allowed_packet = 16M
``` ```
### Databases management ### Database management
```yaml ```yaml
mariadb_databases: [] mariadb_databases: []
@ -159,7 +159,7 @@ mariadb_databases: []
See: <https://docs.ansible.com/ansible/latest/modules/mysql_db_module.html> See: <https://docs.ansible.com/ansible/latest/modules/mysql_db_module.html>
### Users management ### User management
```yaml ```yaml
mariadb_users: [] mariadb_users: []
@ -177,7 +177,7 @@ See: <https://docs.ansible.com/ansible/latest/modules/mysql_user_module.html>
Replication is only enabled if `mariadb_replication_role` has a value (`master` or Replication is only enabled if `mariadb_replication_role` has a value (`master` or
`slave`). `slave`).
The replication setup on the slave use the GTID autopositionning The replication setup on the slave use the GTID autopositioning
`master_use_gtid=slave_pos`. See: `master_use_gtid=slave_pos`. See:
<https://mariadb.com/kb/en/library/change-master-to/#master_use_gtid> <https://mariadb.com/kb/en/library/change-master-to/#master_use_gtid>
@ -218,8 +218,8 @@ mariadb_backup_db_name: []
# - db2 # - db2
``` ```
Database dump is done serially and compression step (`gzip`) is done after to Database dumps are done serially and the compression step (`gzip`) is done after to
avoid too long locks. avoid lengthy locks.
## Example playbook ## Example playbook