mirror of
https://github.com/geerlingguy/ansible-role-apache
synced 2025-01-10 11:50:18 +01:00
91 lines
3 KiB
Markdown
91 lines
3 KiB
Markdown
# Ansible Role: MySQL
|
|
|
|
[](https://travis-ci.org/geerlingguy/ansible-role-mysql)
|
|
|
|
Installs MySQL server on RHEL/CentOS or Debian/Ubuntu servers.
|
|
|
|
## Requirements
|
|
|
|
None.
|
|
|
|
## Role Variables
|
|
|
|
Available variables are listed below, along with default values (see `vars/main.yml`):
|
|
|
|
mysql_user_home: /root
|
|
|
|
The home directory inside which Python MySQL settings will be stored, which Ansible will use when connecting to MySQL. This should be the home directory of the user which runs this Ansible role.
|
|
|
|
mysql_root_password: root
|
|
|
|
The MySQL root user account password.
|
|
|
|
mysql_databases: []
|
|
|
|
The MySQL databases to create. A database has the values `name`, `encoding` (defaults to `utf8`) and `collation` (defaults to `utf8_general_ci`). The formats of these are the same as in the `mysql_db` module.
|
|
|
|
mysql_users: []
|
|
|
|
The MySQL users and their privileges. A user has the values `name`, `host` (defaults to `localhost`), `password` and `priv` (defaults to `*.*:USAGE`). The formats of these are the same as in the `mysql_user` module.
|
|
|
|
mysql_packages:
|
|
- mysql
|
|
- mysql-server
|
|
- MySQL-python
|
|
|
|
(OS-specific, RedHat/CentOS defaults listed here) Packages to be installed. In some situations, you may need to add additional packages, like `mysql-devel`.
|
|
|
|
mysql_enablerepo: ""
|
|
|
|
(RedHat/CentOS only) If you have enabled any additional repositories (might I suggest geerlingguy.repo-epel or geerlingguy.repo-remi), those repositories can be listed under this variable (e.g. `remi,epel`). This can be handy, as an example, if you want to install later versions of MySQL.
|
|
|
|
mysql_port: "3306"
|
|
mysql_datadir: /var/lib/mysql
|
|
mysql_socket: /var/lib/mysql/mysql.sock
|
|
|
|
Default MySQL connection configuration.
|
|
|
|
mysql_log_error: /var/log/mysqld.log
|
|
mysql_syslog_tag: mysqld
|
|
|
|
MySQL logging configuration. Setting `mysql_log_error` to `syslog` will make MySQL log to syslog using the `mysql_syslog_tag`.
|
|
|
|
mysql_key_buffer_size: "256M"
|
|
mysql_max_allowed_packet: "64M"
|
|
mysql_table_open_cache: "256"
|
|
[...]
|
|
|
|
The rest of the settings in `defaults/main.yml` control MySQL's memory usage. The default values are tuned for a server where MySQL can consume ~512 MB RAM, so you should consider adjusting them to suit your particular server better.
|
|
|
|
## Dependencies
|
|
|
|
None.
|
|
|
|
## Example Playbook
|
|
|
|
- hosts: db-servers
|
|
vars_files:
|
|
- vars/main.yml
|
|
roles:
|
|
- { role: geerlingguy.mysql }
|
|
|
|
*Inside `vars/main.yml`*:
|
|
|
|
mysql_root_password: super-secure-password
|
|
mysql_databases:
|
|
- name: example_db
|
|
encoding: latin1
|
|
collation: latin1_general_ci
|
|
mysql_users:
|
|
- name: example_user
|
|
host: "%"
|
|
password: similarly-secure-password
|
|
priv: "example_db.*:ALL"
|
|
|
|
## License
|
|
|
|
MIT / BSD
|
|
|
|
## Author Information
|
|
|
|
This role was created in 2014 by [Jeff Geerling](http://jeffgeerling.com/), author of [Ansible for DevOps](http://ansiblefordevops.com/).
|