community.proxysql.proxysql_replication_hostgroups – Управляет группами узлов репликации с помощью интерфейса администрирования proxysql.

Примечание

Этот плагин входит в коллекцию community.proxysql (версия 1.0.0).

Для его установки используйте: ansible-galaxy collection install community.proxysql.

Для использования в книге задач укажите: community.proxysql.proxysql_replication_hostgroups.

Обзор
Требования
Параметры
Примеры
Возвращаемые значения

Обзор

Каждая строка в mysql_replication_hostgroups представляет пару writer_hostgroup и reader_hostgroup. ProxySQL будет отслеживать значение read_only для всех серверов в указанных группах узлов и, основываясь на значении read_only, назначит сервер группам writer или reader.

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

PyMySQL (Python 2.7 и Python 3.X), или
MySQLdb (Python 2.x)

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
comment строка		Поле текста, которое можно использовать для любых целей, определенных пользователем.
config_file путь	Значение по умолчанию: ""	Укажите файл конфигурации, из которого необходимо считать login_user и login_password.
load_to_runtime логическое	Варианты: no да ←	Динамически загрузить конфигурацию в оперативную память.
login_host строка	Значение по умолчанию: "127.0.0.1"	Хост, используемый для подключения к интерфейсу администрирования ProxySQL.
login_password строка		Пароль, используемый для аутентификации в интерфейсе администрирования ProxySQL.
login_port целое число	Значение по умолчанию: 6032	Порт, используемый для подключения к интерфейсу администрирования ProxySQL.
login_unix_socket строка		Сокет, используемый для подключения к интерфейсу администрирования ProxySQL.
login_user строка		Имя пользователя, используемое для аутентификации в интерфейсе администрирования ProxySQL.
reader_hostgroup целое число / обязательно		Идентификатор группы узлов читателя.
save_to_disk логическое	Варианты: no да ←	Сохранить конфигурацию в базу данных sqlite на диске для сохранения конфигурации.
state строка	Варианты: present ← absent	При значении `present` - добавляет группу узлов репликации, при значении `absent` - удаляет группу узлов репликации.
writer_hostgroup целое число / обязательно		Идентификатор группы узлов писателя.

Примеры

---
# This example adds a replication hostgroup, it saves the mysql server config
# to disk, but avoids loading the mysql server config to runtime (this might be
# because several replication hostgroup are being added and the user wants to
# push the config to runtime in a single batch using the
# community.general.proxysql_manage_config module).  It uses supplied credentials
# to connect to the proxysql admin interface.

- name: Add a replication hostgroup
  community.proxysql.proxysql_replication_hostgroups:
    login_user: 'admin'
    login_password: 'admin'
    writer_hostgroup: 1
    reader_hostgroup: 2
    state: present
    load_to_runtime: False

# This example removes a replication hostgroup, saves the mysql server config
# to disk, and dynamically loads the mysql server config to runtime.  It uses
# credentials in a supplied config file to connect to the proxysql admin
# interface.

- name: Remove a replication hostgroup
  community.proxysql.proxysql_replication_hostgroups:
    config_file: '~/proxysql.cnf'
    writer_hostgroup: 3
    reader_hostgroup: 4
    state: absent

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:

Ключ	Возвращаемое значение	Описание
stdout словарь	При создании/обновлении вернет новую изменённую группу, при удалении вернёт удалённую запись.	Группа узлов репликации, изменённая или удалённая из proxysql Пример: {'changed': True, 'msg': 'Added server to mysql_hosts', 'repl_group': {'comment': '', 'reader_hostgroup': '1', 'writer_hostgroup': '2'}, 'state': 'present'}

Авторы

Ben Mildren (@bmildren)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/proxysql/proxysql_replication_hostgroups_module.html