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

Примечание

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

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

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

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

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

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

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

Требования

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

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 словарь	Группа репликации хостов, измененная или удалённая из 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

словарь

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

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

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

Авторы

Бен Майлден (@bmildren)

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

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