community.proxysql.proxysql_backend_servers – Добавляет или удаляет хосты mysql в интерфейс администрирования proxysql.

Примечание

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

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

Чтобы использовать его в книге задач, укажите: community.proxysql.proxysql_backend_servers.

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

Обзор

Модуль community.proxysql.proxysql_backend_servers добавляет или удаляет хосты mysql с помощью интерфейса администрирования proxysql.

Требования

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

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
comment строка	По умолчанию: ""	Поле текста, которое может использоваться для любых целей, определенных пользователем. Может быть описанием того, что хранит хост, напоминанием о том, когда хост был добавлен или отключен, или JSON-данными, обрабатываемыми каким-либо скриптом-проверяющим.
compression целое число		Если значение compression больше 0, новые подключения к этому серверу будут использовать сжатие. Если опущено, значение по умолчанию для compression в базе данных proxysql равно 0.
config_file путь	По умолчанию: ""	Укажите конфигурационный файл, из которого будут считываться login_user и login_password.
hostgroup_id целое число	По умолчанию: 0	Группа хостов, к которой относится этот экземпляр mysqld. Экземпляр может входить в одну или несколько групп хостов.
hostname строка / обязательно		IP-адрес, по которому можно связаться с экземпляром mysqld.
load_to_runtime булево	Варианты: нет да ←	Динамическая загрузка конфигурации в оперативную память.
login_host строка	По умолчанию: "127.0.0.1"	Хост, используемый для подключения к интерфейсу администрирования ProxySQL.
login_password строка		Пароль, используемый для аутентификации в интерфейсе администрирования ProxySQL.
login_port целое число	По умолчанию: 6032	Порт, используемый для подключения к интерфейсу администрирования ProxySQL.
login_unix_socket строка		Сокет, используемый для подключения к интерфейсу администрирования ProxySQL.
login_user строка		Имя пользователя, используемое для аутентификации в интерфейсе администрирования ProxySQL.
max_connections целое число		Максимальное количество подключений, которые ProxySQL будет открывать к этому серверу-бекенду. Если опущено, значение по умолчанию для max_connections в базе данных proxysql равно 1000.
max_latency_ms целое число		Время пинга отслеживается регулярно. Если время пинга хоста превышает max_latency_ms, хост исключается из пула подключений (хотя сервер остается ONLINE). Если опущено, значение по умолчанию для max_latency_ms в базе данных proxysql равно 0.
max_replication_lag целое число		Если больше 0, ProxySQL будет регулярно отслеживать задержку репликации. Если задержка репликации превысит max_replication_lag, proxysql временно отклонит сервер, пока репликация не догонит. Если опущено, значение по умолчанию для max_replication_lag в базе данных proxysql равно 0.
port целое число	По умолчанию: 3306	Порт, по которому можно связаться с экземпляром mysqld.
save_to_disk булево	Варианты: нет да ←	Сохранить конфигурацию в базу данных sqlite на диске для сохранения конфигурации.
state строка	Варианты: present ← absent	Когда `present` - добавляет хост, когда `absent` - удаляет хост.
status строка	Варианты: ONLINE OFFLINE_SOFT OFFLINE_HARD	ONLINE - сервер-бекенд полностью функционирует. OFFLINE_SOFT - когда сервер переводится в режим `OFFLINE_SOFT`, подключения сохраняются в использовании до завершения текущей транзакции. Это позволяет плавно отсоединить бекенд. OFFLINE_HARD - когда сервер переводится в режим `OFFLINE_HARD`, существующие подключения прерываются, а новые входящие подключения также не принимаются. Если опущено, значение по умолчанию для status в базе данных proxysql равно `ONLINE`.
use_ssl булево	Варианты: нет да	Если use_ssl установлено в `True`, подключения к этому серверу будут создаваться с использованием SSL-подключений. Если опущено, значение по умолчанию для use_ssl в базе данных proxysql равно `False`.
weight целое число		Чем больше вес сервера по отношению к другим весам, тем выше вероятность, что сервер будет выбран из группы хостов. Если опущено, значение по умолчанию для weight в базе данных proxysql равно 1.

Примеры

---
# This example adds a server, it saves the mysql server config to disk, but
# avoids loading the mysql server config to runtime (this might be because
# several servers 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 server
  community.proxysql.proxysql_backend_servers:
    login_user: 'admin'
    login_password: 'admin'
    hostname: 'mysql01'
    state: present
    load_to_runtime: False

# This example removes a server, 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 server
  community.proxysql.proxysql_backend_servers:
    config_file: '~/proxysql.cnf'
    hostname: 'mysql02'
    state: absent

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

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

Ключ	Возвращаемое значение	Описание
stdout словарь	При создании/обновлении вернет измененный хост, при удалении вернет удаленный элемент.	Измененный или удаленный хост mysql из proxysql Пример: {'changed': True, 'hostname': '192.168.52.1', 'msg': 'Добавлен сервер в mysql_hosts', 'server': {'comment': '', 'compression': '0', 'hostgroup_id': '1', 'hostname': '192.168.52.1', 'max_connections': '1000', 'max_latency_ms': '0', 'max_replication_lag': '0', 'port': '3306', 'status': 'ONLINE', 'use_ssl': '0', 'weight': '1'}, '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_backend_servers_module.html