mysql_replication – Управление репликацией MySQL
Краткое описание
- Управляет репликацией сервера MySQL, получением и изменением состояния раба и мастера.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- PyMySQL (Python 2.7 и Python 3.X), или
- MySQLdb (Python 2.x)
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| ca_cert путь | Путь к сертификату Удостоверяющего центра (CA). Если используется, этот параметр должен указывать на тот же сертификат, что и сервер. Псевдонимы: ssl_ca | |
| client_cert путь | Путь к клиенту сертификату открытого ключа. Псевдонимы: ssl_cert | |
| client_key путь | Путь к закрытому ключу клиента. Псевдонимы: ssl_key | |
| config_file путь | По умолчанию: "~/.my.cnf" | Укажите конфигурационный файл, из которого необходимо считывать пользователя и пароль. |
| connect_timeout целое число | По умолчанию: 30 | Время ожидания соединения при подключении к серверу MySQL. |
| login_host строка | По умолчанию: "localhost" | Хост, на котором работает база данных. |
| login_password строка | Пароль, используемый для аутентификации. | |
| login_port целое число | По умолчанию: 3306 | Порт сервера MySQL. Требуется, чтобы login_host был определен как отличный от localhost, если используется login_port. |
| login_unix_socket строка | Путь к сокету Unix доменного имени для локальных соединений. | |
| login_user строка | Имя пользователя, используемое для аутентификации. | |
| master_auto_position логический тип |
| Использует ли хост репликацию на основе GTID. |
| master_connect_retry целое число | Аналогично переменной mysql. | |
| master_host строка | Аналогично переменной mysql. | |
| master_log_file строка | Аналогично переменной mysql. | |
| master_log_pos целое число | Аналогично переменной mysql. | |
| master_password строка | Аналогично переменной mysql. | |
| master_port целое число | Аналогично переменной mysql. | |
| master_ssl логический тип |
| Аналогично переменной mysql. |
| master_ssl_ca строка | Аналогично переменной mysql. | |
| master_ssl_capath строка | Аналогично переменной mysql. | |
| master_ssl_cert строка | Аналогично переменной mysql. | |
| master_ssl_cipher строка | Аналогично переменной mysql. | |
| master_ssl_key строка | Аналогично переменной mysql. | |
| master_user строка | Аналогично переменной mysql. | |
| mode строка |
| Режим работы модуля. Может быть получить_статус_раба (SHOW SLAVE STATUS), получить_статус_мастера (SHOW MASTER STATUS), изменить_мастер (CHANGE MASTER TO), запустить_раба (START SLAVE), остановить_раба (STOP SLAVE), сбросить_раба (RESET SLAVE), сбросить_всех_рабов (RESET SLAVE ALL) |
| relay_log_file строка | Аналогично переменной mysql. | |
| relay_log_pos целое число | Аналогично переменной mysql. |
Примечания
Примечание
- Требуется пакет PyMySQL (Python 2.7 и Python 3.X) или MySQL-python (Python 2.X) на удалённом хосте. Пакет Python можно установить с помощью apt-get install python-pymysql (Ubuntu; см. apt) или yum install python2-PyMySQL (RHEL/CentOS/Fedora; см. yum). Вы также можете использовать dnf install python2-PyMySQL для более новых версий Fedora; см. dnf.
- И
login_passwordиlogin_userнеобходимы при передаче учетных данных. Если они отсутствуют, модуль попытается прочитать учетные данные из~/.my.cnf, и, наконец, вернется к использованию стандартных учетных данных MySQL 'root' без пароля.
Примеры
# Stop mysql slave thread
- mysql_replication:
mode: stopslave
# Get master binlog file name and binlog position
- mysql_replication:
mode: getmaster
# Change master to master server 192.0.2.1 and use binary log 'mysql-bin.000009' with position 4578
- mysql_replication:
mode: changemaster
master_host: 192.0.2.1
master_log_file: mysql-bin.000009
master_log_pos: 4578
# Check slave status using port 3308
- mysql_replication:
mode: getslave
login_host: ansible.example.com
login_port: 3308
Статус
- Гарантии обратной совместимости интерфейса этого модуля нет. [предварительный просмотр]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Balazs Pocze (@banyek)
Подсказка
Если вы заметите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/mysql_replication_module.html
