proxysql_mysql_users – Добавляет или удаляет пользователей mysql в интерфейс администрирования proxysql
Описание
- Модуль proxysql_mysql_users добавляет или удаляет пользователей mysql с помощью интерфейса администрирования proxysql.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- PyMySQL (Python 2.7 и Python 3.X), или
- MySQLdb (Python 2.x)
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| active boolean |
| Пользователь с active, установленным в False, будет отслеживаться в базе данных, но никогда не загружаться в структуры данных в оперативной памяти. Если опущено, значение по умолчанию для active в базе данных proxysql - True. |
| backend boolean |
| Если backend установлено в True, эта пара (имя пользователя, пароль) используется для аутентификации в экземпляре ProxySQL. |
| config_file путь | Значение по умолчанию: "" | Укажите файл конфигурации, из которого следует читать login_user и login_password. |
| default_hostgroup - | Если для запросов, отправленных этим пользователем, нет соответствующих правил, трафик, который он генерирует, отправляется в указанную группу хостов. Если опущено, значение по умолчанию для use_ssl в базе данных proxysql - 0. | |
| default_schema - | Схема, в которую по умолчанию должна переключаться связь. | |
| fast_forward boolean |
| Если fast_forward установлено в True, fast_forward пропустит слой обработки запросов (переписывание, кэширование) и передаст запрос напрямую обратному серверу в том виде, в котором он есть. Если опущено, значение по умолчанию для fast_forward в базе данных proxysql - False. |
| frontend boolean |
| Если frontend установлено в True, эта пара (имя пользователя, пароль) используется для аутентификации на серверах mysqld для любой группы хостов. |
| load_to_runtime boolean |
| Динамическая загрузка конфигурации в оперативную память. |
| login_host строка | Значение по умолчанию: "127.0.0.1" | Хост, используемый для подключения к интерфейсу администрирования ProxySQL. |
| login_password строка | Пароль, используемый для аутентификации в интерфейсе администрирования ProxySQL. | |
| login_port целое число | Значение по умолчанию: 6032 | Порт, используемый для подключения к интерфейсу администрирования ProxySQL. |
| login_user строка | Имя пользователя, используемое для аутентификации в интерфейсе администрирования ProxySQL. | |
| max_connections - | Максимальное количество подключений, которые ProxySQL откроет к обратному серверу для этого пользователя. Если опущено, значение по умолчанию для max_connections в базе данных proxysql - 10000. | |
| password - | Пароль пользователя, подключающегося к mysqld или экземпляру ProxySQL. | |
| save_to_disk boolean |
| Сохранить конфигурацию в базе данных sqlite на диске для сохранения конфигурации. |
| state - |
| При значении present - добавляет пользователя, при значении absent - удаляет пользователя. |
| transaction_persistent boolean |
| Если это установлено для пользователя, с которым MySQL-клиент подключается к ProxySQL (следовательно, пользователь «frontend»), транзакции, начатые в группе хостов, останутся в этой группе хостов независимо от других правил. Если опущено, значение по умолчанию для transaction_persistent в базе данных proxysql - False. |
| use_ssl boolean |
| Если use_ssl установлено в True, соединения этого пользователя будут выполняться с использованием SSL-соединений. Если опущено, значение по умолчанию для use_ssl в базе данных proxysql - False. |
| username - / обязательно | Имя пользователя, подключающегося к mysqld или экземпляру ProxySQL. |
Примеры
---
# This example adds a user, it saves the mysql user config to disk, but
# avoids loading the mysql user config to runtime (this might be because
# several users are being added and the user wants to push the config to
# runtime in a single batch using the M(proxysql_manage_config) module). It
# uses supplied credentials to connect to the proxysql admin interface.
- proxysql_mysql_users:
login_user: 'admin'
login_password: 'admin'
username: 'productiondba'
state: present
load_to_runtime: False
# This example removes a user, saves the mysql user config to disk, and
# dynamically loads the mysql user config to runtime. It uses credentials
# in a supplied config file to connect to the proxysql admin interface.
- proxysql_mysql_users:
config_file: '~/proxysql.cnf'
username: 'mysqlboy'
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| stdout словарь | При создании/обновлении возвращает только что изменённого пользователя, при удалении — удалённую запись. | Пользователь mysql, изменённый или удалённый из proxysql Пример: {'changed': True, 'msg': 'Пользователь добавлен в mysql_users', 'state': 'present', 'user': {'active': 1, 'backend': 1, 'default_hostgroup': 1, 'default_schema': None, 'fast_forward': 0, 'frontend': 1, 'max_connections': 10000, 'password': 'VALUE_SPECIFIED_IN_NO_LOG_PARAMETER', 'schema_locked': 0, 'transaction_persistent': 0, 'use_ssl': 0, 'username': 'guest_ro'}, 'username': 'guest_ro'} |
Статус
- Изменения интерфейса этого модуля гарантированно будут совместимы со старыми версиями в будущем. [stableinterface]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Ben Mildren (@bmildren)
Подсказка
Если вы обнаружите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/proxysql_mysql_users_module.html
