proxysql_mysql_users — Добавление или удаление пользователей MySQL в интерфейсе администрирования ProxySQL.
Новая в версии 2.3.
Обзор
- Модуль proxysql_mysql_users добавляет или удаляет пользователей MySQL с использованием интерфейса администрирования ProxySQL.
Параметры
| параметр | обязательно | по умолчанию | варианты | комментарии |
|---|---|---|---|---|
| active |
нет | Пользователь с active, установленным в False, будет отслеживаться в базе данных, но никогда не загружаться во внутренние структуры данных. Если параметр опущен, значение по умолчанию для active в базе данных ProxySQL — True. |
||
| backend |
нет | True | Если backend установлено в True, эта пара (имя пользователя, пароль) используется для аутентификации в экземпляре ProxySQL. |
|
| config_file |
нет | Укажите конфигурационный файл, из которого необходимо считать значения login_user и login_password. |
||
| default_hostgroup |
нет | Если для запросов, отправленных этим пользователем, нет соответствующего правила, трафик, который он генерирует, отправляется в указанную группу хостов. Если параметр опущен, значение по умолчанию для use_ssl в базе данных ProxySQL — 0. |
||
| default_schema |
нет | Схема, к которой должно происходить подключение по умолчанию. |
||
| fast_forward |
нет | Если fast_forward установлено в True, fast_forward пропустит обработку запроса (переписывание, кэширование) и передаст запрос напрямую обратно серверу. Если параметр опущен, значение по умолчанию для fast_forward в базе данных ProxySQL — False. |
||
| frontend |
нет | True | Если frontend установлено в True, эта пара (имя пользователя, пароль) используется для аутентификации на серверах mysqld для любой группы хостов. |
|
| load_to_runtime |
нет | True | Динамически загружает конфигурацию хостов MySQL в оперативную память. |
|
| login_host |
нет | 127.0.0.1 | Хост, используемый для подключения к интерфейсу администрирования ProxySQL. |
|
| login_password |
нет | None | Пароль, используемый для аутентификации в интерфейсе администрирования ProxySQL. |
|
| login_port |
нет | 6032 | Порт, используемый для подключения к интерфейсу администрирования ProxySQL. |
|
| login_user |
нет | None | Имя пользователя, используемое для аутентификации в интерфейсе администрирования ProxySQL. |
|
| max_connections |
нет | Максимальное количество подключений, которые ProxySQL откроет для этого пользователя к серверу backend. Если параметр опущен, значение по умолчанию для max_connections в базе данных ProxySQL — 10000. |
||
| password |
нет | Пароль пользователя, подключающегося к экземпляру mysqld или ProxySQL. |
||
| save_to_disk |
нет | True | Сохраняет конфигурацию хостов MySQL в базу данных SQLite на диске для сохранения настроек. |
|
| state |
нет | present |
|
При значении present, добавляет пользователя; при значении absent, удаляет пользователя. |
| transaction_persistent |
нет | Если данное значение установлено для пользователя, с которым клиент MySQL подключается к ProxySQL (т.е., «пользователь frontend»), транзакции, начатые в группе хостов, останутся в этой группе хостов независимо от других правил. Если параметр опущен, значение по умолчанию для transaction_persistent в базе данных ProxySQL — False. |
||
| use_ssl |
нет | Если 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 |
При создании/обновлении возвращает нового измененного пользователя; при удалении — удаленную запись. | dict | {'msg': 'Пользователь добавлен в mysql_users', 'username': 'guest_ro', 'state': 'present', 'changed': True, 'user': {'default_hostgroup': 1, 'username': 'guest_ro', 'frontend': 1, 'default_schema': None, 'transaction_persistent': 0, 'schema_locked': 0, 'backend': 1, 'fast_forward': 0, 'active': 1, 'use_ssl': 0, 'password': 'VALUE_SPECIFIED_IN_NO_LOG_PARAMETER', 'max_connections': 10000}} |
Статус
Этот модуль помечен как stableinterface, что означает, что разработчики данного модуля гарантируют, что не будут вноситься несовместимые изменения в интерфейс.
Для получения помощи в разработке модулей обратитесь к документации Информация о сообществе и участие в разработке, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/proxysql_mysql_users_module.html
