community.proxysql.proxysql_galera_hostgroups модуль — Управление группами узлов Galera с помощью интерфейса администрирования Proxysql
Примечание
Этот модуль входит в коллекцию community.proxysql (версия 1.6.0).
У вас, возможно, уже установлена эта коллекция, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install community.proxysql. Для использования этого модуля потребуются дополнительные требования. Подробности см. в разделе Требования.
Чтобы использовать его в плейбуке, укажите: community.proxysql.proxysql_galera_hostgroups.
Обзор
- В отличие от обычной асинхронной репликации, группы узлов Galera НЕ определяются в таблице mysql_replication_hostgroups. Вместо этого есть отдельная таблица, специально предназначенная для групп узлов Galera. Причина в том, что для поддержки более сложных топологий требуется больше функций, чтобы учесть доступные варианты развертывания Galera (например, контролируемое количество записывающих узлов, пороговые значения репликации на уровне кластера и т. д.).
Требования
Ниже перечислены требования, которые должны быть выполнены на хосте, на котором выполняется этот модуль.
- PyMySQL
- mysqlclient
Параметры
Параметр | Комментарии |
|---|---|
active integer | Включена (1) или выключена (0) настроенная конфигурация группы хостов. Варианты:
|
backup_writer_hostgroup integer / required | Идентификатор группы хостов, которая будет содержать все узлы Galera, являющиеся резервными записывающими. |
comment string | Текстовое поле, которое может использоваться для любых целей, определенных пользователем. По умолчанию: |
config_file path | Укажите файл конфигурации, из которого будут читаться login_user и login_password. По умолчанию: |
load_to_runtime boolean | Динамически загрузить конфигурацию в оперативную память. Варианты:
|
login_host string | Хост, используемый для подключения к интерфейсу администратора ProxySQL. По умолчанию: |
login_password string | Пароль, используемый для аутентификации в интерфейсе администратора ProxySQL. |
login_port integer | Порт, используемый для подключения к интерфейсу администратора ProxySQL. По умолчанию: |
login_unix_socket string | Сокет, используемый для подключения к интерфейсу администратора ProxySQL. |
login_user string | Имя пользователя, используемое для аутентификации в интерфейсе администратора ProxySQL. |
max_transactions_behind integer | максимальное количество write-сетов позади кластера, которое ProxySQL должен разрешать, прежде чем отключать узел, чтобы предотвратить устаревшие чтения По умолчанию: |
max_writers integer | число экземпляров чтения-записи, заполненных в группе записывающих хостов По умолчанию: |
offline_hostgroup integer / required | Идентификатор группы хостов, в которую будут перемещены все неисправные узлы. |
reader_hostgroup integer / required | Идентификатор группы хостов, которая будет содержать все узлы Galera, являющиеся читающими. |
save_to_disk boolean | Сохранить конфигурацию в sqlite db на диске для сохранения конфигурации. Варианты:
|
state string | Когда Варианты:
|
writer_hostgroup integer / required | Идентификатор группы хостов, которая будет содержать все узлы Galera, являющиеся активными записывающими. |
writer_is_also_reader integer | writer_is_also_reader - 0 узлы с `read_only=0` будут размещены либо в writer_hostgroup, либо в backup_writer_hostgroup после изменения топологии, они будут исключены из reader_hostgroup writer_is_also_reader - 1 узлы с `read_only=0` будут размещены в writer_hostgroup или backup_writer_hostgroup и также размещены в reader_hostgroup после изменения топологии writer_is_also_reader - 2 Только узлы с `read_only=0`, которые размещены в backup_writer_hostgroup, также размещаются в reader_hostgroup после изменения топологии, т.е. узлы с `read_only=0`, превышающие заданное значение `max_writers`. Варианты:
|
Примечания
Примечание
- Поддерживает
check_mode.
Примеры
---
# This example adds a new galera hostgroup, it saves the mysql server config
# to disk and loads it to a runtime and also enables the config which has
# maximum of 2 writers from the writers_hostgroup.
- name: Add a galera hostgroup
community.proxysql_galera_hostgroups:
login_user: "admin"
login_password: "admin"
writer_hostgroup: 1
backup_writer_hostgroup: 2
reader_hostgroup: 3
offline_hostgroup: 4
active: 1
max_writers: 2
writer_is_also_reader: 0
# This example disables galera hostgroup by setting active to 0
- name: Disable a galera hostgroup
community.proxysql_galera_hostgroups:
login_user: "admin"
login_password: "admin"
writer_hostgroup: 1
backup_writer_hostgroup: 2
reader_hostgroup: 3
offline_hostgroup: 4
active: 0
# This example removes a galera hostgroup from configuration,
# saves the mysql server config to disk, and 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 galera hostgroup
community.proxysql_galera_hostgroups:
config_file: '/tmp/proxysql.cnf'
writer_hostgroup: 0
backup_writer_hostgroup: 1
reader_hostgroup: 2
offline_hostgroup: 3
active: 0
state: absent
Значения возврата
Общие значения возврата документированы здесь, следующие поля уникальны для этого модуля:
Ключ | Описание |
|---|---|
stdout словарь | Изменённая или удалённая группа хостов Galera из proxysql. Возвращаемое значение: При создании/обновлении вернёт новую изменённую группу, при удалении — удалённую запись. Пример: |
Ссылки на коллекцию
© 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_galera_hostgroups_module.html
