95 lines
3.4 KiB
Markdown
95 lines
3.4 KiB
Markdown
MySQL vendors for Debian Ansible role
|
|
======================================
|
|
|
|
[](https://galaxy.ansible.com/HanXHX/mysql) [](https://travis-ci.org/HanXHX/ansible-mysql)
|
|
|
|
Install and configure MySQL or MariaDB (Galera Cluster) or Percona Server. Manage replication (master/slave). Create users and databases.
|
|
|
|
| OS | Vendor | Origin | Managed versions |
|
|
| --------------- | ----------------------- | --------- | ------------------------- |
|
|
| Debian Jessie | MySQL | Debian | 5.5 / 5.6 |
|
|
| Debian Jessie | MariaDB | Debian | 10.0 |
|
|
| Debian Jessie | MariaDB | Upstream | 10.0 / 10.1 / 10.2 / 10.3 |
|
|
| Debian Jessie | MariaDB Galera Cluster | Upstream | 10.1 / 10.2 |
|
|
| Debian Jessie | Percona server | Upstream | 5.5 / 5.6 / 5.7 |
|
|
| Debian Stretch | MariaDB | Debian | 10.1 |
|
|
| Debian Stretch | MariaDB | Upstream | 10.1 / 10.2 / 10.3 |
|
|
| Debian Stretch | MariaDB Galera Cluster | Upstream | 10.1 / 10.2 |
|
|
|
|
Notes
|
|
-----
|
|
|
|
* MySQL 5.6 on Jessie needs backports repository
|
|
* MySQL server no longer exists on Debian Stretch
|
|
* Percona Server is not available (soon?) on Debian Stretch
|
|
* Galera Cluster is experimental
|
|
* Due to Vagrant + Docker limitation (private network), replication/galera can't be checked with Travis
|
|
* If you need to test this role with Vagrant, you must install hostmanager plugin: `vagrant plugin install vagrant-hostmanager`
|
|
|
|
Requirements
|
|
------------
|
|
|
|
None.
|
|
|
|
Role Variables
|
|
--------------
|
|
|
|
- `mysql_origin`: origin of the package ("default" or "upstream")
|
|
- `mysql_vendor`: "mysql", "mariadb", "mariadb\_galera" (only with MariaDB upstream 10.1) or "percona"
|
|
|
|
### Configuration
|
|
|
|
- `mysql_root_password`: root password (should be protected with [vault](http://docs.ansible.com/playbooks_vault.html))
|
|
|
|
If you need a feature you can't configure, you can use this list. These config will go to `/etc/mysql/conf.d/01-extra`.
|
|
|
|
- `mysql_extra_config`: key/value hash see [default vars file](defaults/main.yml)
|
|
|
|
### Databases
|
|
|
|
- `mysql_databases`: list...
|
|
|
|
### Users
|
|
|
|
Example:
|
|
|
|
```
|
|
mysql_users:
|
|
- name: 'kiki'
|
|
password: '123'
|
|
priv: hihi.*:ALL
|
|
host: '%'
|
|
```
|
|
|
|
Check "priv" syntax in [mysql\_user module documentation](http://docs.ansible.com/mysql_user_module.html)
|
|
|
|
### Packaging
|
|
|
|
- `mysql_mariadb_version`: 10.0 / 10.1 / 10.2
|
|
- `mysql_mariadb_repository`: MariaDB upstream APT repository (see: [MariaDB repositories tool](https://downloads.mariadb.org/mariadb/repositories))
|
|
- `mysql_percona_version`: 5.5 / 5.6 / 5.7
|
|
- `mysql_percona_repository`: Percona upstream APT repository (see: [Percona APT doc](http://www.percona.com/doc/percona-server/5.5/installation/apt_repo.html))
|
|
- `mysql_use_percona_apt`: Force using Percona APT repository (useful when you want to use latest version of percona toolkits, xtrabackup... etc)
|
|
|
|
Dependencies
|
|
------------
|
|
|
|
None.
|
|
|
|
Example Playbook
|
|
----------------
|
|
|
|
- hosts: servers
|
|
roles:
|
|
- { role: HanXHX.mysql, mysql_origin: 'upstream', mysql_vendor: 'mariadb' }
|
|
|
|
License
|
|
-------
|
|
|
|
GPLv2
|
|
|
|
Author Information
|
|
------------------
|
|
|
|
- Twitter: [@hanxhx_](https://twitter.com/hanxhx_)
|