mysql_replication – Управление репликацией MySQL
Новая в версии 1.3.
Описание
- Управление репликацией сервера MySQL, получение и изменение статуса слейва, мастера.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- PyMySQL (Python 2.7 и Python 3.X), или
- MySQLdb (Python 2.x)
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| config_file - добавлен в 2.0 | По умолчанию: "~/.my.cnf" | Укажите конфигурационный файл, из которого должны быть считанные имя пользователя и пароль. |
| connect_timeout - добавлен в 2.1 | По умолчанию: 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 - добавлен в 2.0 | Использует ли хост репликацию на основе 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 - |
| Режим работы модуля. Может быть getslave (SHOW SLAVE STATUS), getmaster (SHOW MASTER STATUS), changemaster (CHANGE MASTER TO), startslave (START SLAVE), stopslave (STOP SLAVE), resetslave (RESET SLAVE), resetslaveall (RESET SLAVE ALL) |
| relay_log_file - | То же, что и переменная mysql. | |
| relay_log_pos - | То же, что и переменная mysql. | |
| ssl_ca - добавлен в 2.0 | Путь к сертификату Центра сертификации (CA). Если используется, этот параметр должен указывать тот же сертификат, что и сервер. | |
| ssl_cert - добавлен в 2.0 | Путь к клиенту открытому сертификату. | |
| ssl_key - добавлен в 2.0 | Путь к закрытому ключу клиента. |
Примечания
Примечание
- Требуется пакет PyMySQL (Python 2.7 и Python 3.X) или MySQL-python (Python 2.X) для Python на удалённом хосте. Для Ubuntu это так же просто, как apt-get install python-pymysql. (См. apt.) Для CentOS/Fedora, это так же просто, как yum install python2-PyMySQL. (См. yum.)
- И
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. [community]
Авторы
- 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.7/modules/mysql_replication_module.html
