proxysql_mysql_users – Добавляет или удаляет пользователей mysql из интерфейса администрирования proxysql.
Новая в версии 2.3.
Описание
- Модуль proxysql_mysql_users добавляет или удаляет пользователей mysql с помощью интерфейса администрирования proxysql.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- PyMySQL (Python 2.7 и Python 3.X), или
- MySQLdb (Python 2.x)
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| active - | Пользователь с active, установленным в False, будет отслеживаться в базе данных, но никогда не загружаться в структуры памяти. Если опущено, значение по умолчанию для active в базе данных proxysql равно True. | |
| backend - | По умолчанию: "да" | Если 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 - | По умолчанию: "да" | Если 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 - | Если это значение установлено для пользователя, с которым клиент MySQL подключается к ProxySQL (т. е. "передний" пользователь), транзакции, начатые в группе хостов, останутся в этой группе хостов независимо от других правил. Если опущено, значение по умолчанию для 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 словарь | При создании/обновлении вернет недавно измененного пользователя, при удалении вернет удаленный запис. | Измененный или удаленный из proxysql пользователь mysql Пример: {'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]
Авторы
- Бен Милдрен (@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.7/modules/proxysql_mysql_users_module.html
