Модуль community.proxysql.proxysql_replication_hostgroups — управляет группами хостов репликации с помощью интерфейса администрирования ProxySQL

Примечание

Этот модуль входит в коллекцию community.proxysql (версия 1.8.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.proxysql. Для использования этого модуля требуются дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в сценарии, укажите: community.proxysql.proxysql_replication_hostgroups.

Краткое описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Краткое описание

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

Требования

На узле, где выполняется этот модуль, необходимы следующие компоненты.

PyMySQL
mysqlclient

Параметры

Параметр	Комментарии
check_type string добавлен в community.proxysql 1.3.0	Тип проверки, используемый для определения того, является ли узел резервным. Требуется proxysql >= 2.0.1. В противном случае параметр не действует. Для `read_only\|innodb_read_only` и `read_only&innodb_read_only` требуется proxysql >= 2.0.8. Варианты: `"read_only"` ← (по умолчанию) `"innodb_read_only"` `"super_read_only"` `"read_only\|innodb_read_only"` `"read_only&innodb_read_only"`
comment string	Текстовое поле, которое пользователь может использовать для любых целей. По умолчанию: `""`
config_file path	Укажите файл конфигурации, из которого будут считываться login_user и login_password. По умолчанию: `""`
load_to_runtime boolean	Динамически загружать конфигурацию в память среды выполнения. Варианты: `false` `true` ← (по умолчанию)
login_host string	Узел для подключения к интерфейсу администрирования ProxySQL. По умолчанию: `"127.0.0.1"`
login_password string	Пароль для аутентификации в интерфейсе администрирования ProxySQL.
login_port integer	Порт для подключения к интерфейсу администрирования ProxySQL. По умолчанию: `6032`
login_unix_socket string	Сокет для подключения к интерфейсу администрирования ProxySQL.
login_user string	Имя пользователя для аутентификации в интерфейсе администрирования ProxySQL.
reader_hostgroup integer / обязательный	Идентификатор группы хостов для чтения.
save_to_disk boolean	Сохранять конфигурацию в базе данных sqlite на диске, чтобы обеспечить её сохранность. Варианты: `false` `true` ← (по умолчанию)
state string	Если задано `present`, добавляет группу хостов репликации; если задано `absent`, удаляет группу хостов репликации. Варианты: `"present"` ← (по умолчанию) `"absent"`
writer_hostgroup integer / обязательный	Идентификатор группы хостов для записи.

Примечания

Примечание

Поддерживает check_mode.

Примеры

---
# 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

- name: Change check_type
  community.proxysql.proxysql_replication_hostgroups:
    login_user: 'admin'
    login_password: 'admin'
    writer_hostgroup: 1
    reader_hostgroup: 2
    check_type: innodb_read_only
    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 dictionary	Группа хостов репликации, изменённая или удалённая из proxysql. Возвращается: При создании или обновлении возвращает изменённую группу; при удалении — удалённую запись. Пример: `{"changed": true, "msg": "Added server to mysql_hosts", "repl_group": {"check_type": "read_only", "comment": "", "reader_hostgroup": "1", "writer_hostgroup": "2"}, "state": "present"}`

Ключ

Описание

stdout

dictionary

Группа хостов репликации, изменённая или удалённая из proxysql.

Возвращается: При создании или обновлении возвращает изменённую группу; при удалении — удалённую запись.

Пример: {"changed": true, "msg": "Added server to mysql_hosts", "repl_group": {"check_type": "read_only", "comment": "", "reader_hostgroup": "1", "writer_hostgroup": "2"}, "state": "present"}

Авторы

Ben Mildren (@bmildren)

Ссылки на коллекцию

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