proxysql_mysql_users – Добавляет или удаляет пользователей mysql из админ-интерфейса proxysql
Новое в версии 2.3.
Обзор
- Модуль 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.8/modules/proxysql_mysql_users_module.html
