f5networks.f5_modules.bigip_monitor_mysql – Управляет мониторами BIG-IP MySQL
Примечание
Этот плагин входит в коллекцию f5networks.f5_modules (версия 1.7.1).
Для его установки используйте: ansible-galaxy collection install f5networks.f5_modules.
Для использования в плейбуке укажите: f5networks.f5_modules.bigip_monitor_mysql.
Новое в версии 1.3.0: модуля f5networks.f5_modules
Обзор
- Управляет мониторами BIG-IP MySQL.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| app_service строка | Служба iApp, которая должна быть ассоциирована с этим профилем. Если служба не указана, значение по умолчанию — None. | ||
| count целое число | Указывает количество зондирований монитора, после которого соединение с базой данных прерывается. | ||
| database строка | Указывает имя базы данных, к которой монитор пытается получить доступ. | ||
| debug логическое |
| Указывает, отправляет ли монитор сообщения об ошибках и дополнительную информацию в файл журнала, созданный и помеченный специально для этого монитора. | |
| description строка | Указывает описательный текст, идентифицирующий монитор. | ||
| interval целое число | Указывает частоту, с которой система выполняет проверку монитора. | ||
| ip строка | Часть IP-адреса в определении IP/порт. Если этот параметр не задан при создании нового монитора, значение по умолчанию — '*'. | ||
| manual_resume логическое |
| Указывает, автоматически ли система изменяет статус ресурса на enabled при следующей успешной проверке монитора. Если вы установите этот параметр в yes, вы должны вручную повторно включить ресурс, прежде чем система сможет использовать его для балансировки нагрузки.Когда yes, указывает, что необходимо вручную повторно включить ресурс после неуспешной проверки монитора.Когда no, указывает, что система автоматически изменяет статус ресурса на enabled при следующей успешной проверке монитора. | |
| name строка / обязательно | Имя монитора. | ||
| parent строка | Родительская шаблон этого шаблона монитора. После установки этого значения его нельзя изменить. По умолчанию это значение — mysql родительский на Common разбиении. | ||
| partition строка | Значение по умолчанию: "Common" | Раздел устройства для управления ресурсами. | |
| port строка | Часть адреса порта в определении IP/порт. Если этот параметр не задан при создании нового монитора, значение по умолчанию — '*'. Если вы указываете IP-адрес, вы должны указать значение от 1 до 65535. | ||
| provider словарь добавлен в версии 1.0.0 f5networks.f5_modules | Объект словаря, содержащий данные подключения. | ||
| auth_provider строка | Настраивает поставщика аутентификации для получения токенов аутентификации от удаленного устройства. Этот параметр действительно используется при работе с устройствами BIG-IQ. | ||
| no_f5_teem логическое |
| Если yes, данные телеметрии TEEM не отправляются в F5.Вы можете опустить этот параметр, установив переменную среды F5_TEEM. | |
| password строка / обязательно | Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, установив переменную среды F5_PASSWORD.псевдонимы: pass, pwd | ||
| server строка / обязательно | Хост BIG-IP. Вы можете опустить этот параметр, установив переменную среды F5_SERVER. | ||
| server_port целое число | Значение по умолчанию: 443 | Порт сервера BIG-IP. Вы можете опустить этот параметр, установив переменную среды F5_SERVER_PORT. | |
| timeout целое число | Указывает время ожидания в секундах для связи с сетевым устройством для подключения или отправки команд. Если время ожидания истекает до завершения операции, модуль выдаст ошибку. | ||
| transport строка |
| Настраивает транспортное соединение, используемое при подключении к удаленному устройству. | |
| user строка / обязательно | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, установив переменную среды F5_USER. | ||
| validate_certs логическое |
| Если no, сертификаты SSL не проверяются. Используйте только на контролируемых вами сайтах, использующих самозаверенные сертификаты.Вы можете опустить этот параметр, установив переменную среды F5_VALIDATE_CERTS. | |
| recv строка | Указывает текстовую строку, которую монитор ищет в возвращенном ресурсе. Наиболее распространенные выражения для приема содержат текстовую строку, которая включена в поле вашей базы данных. Если вы не укажете как строку отправки, так и строку приема, монитор выполнит простую проверку службы и только подключение. | ||
| recv_column строка | Указывает столбец в базе данных, где система ожидает местоположения указанной строки приема. Это необязательная настройка, применимая только в том случае, если вы настроите параметры send и recv. | ||
| recv_row строка | Указывает строку в базе данных, где система ожидает местоположения указанной строки приема. Это необязательная настройка, применимая только в том случае, если вы настроите параметры send и recv. | ||
| send строка | Указывает SQL-запрос, который монитор отправляет целевому объекту. Поскольку строка может содержать специальные символы, системе может потребоваться заключить строку в одинарные кавычки. Если это значение — none, то достаточным для определения работоспособности службы является корректное соединение. В этом случае системе не нужны параметры recv, recv-row и recv-column, и она их игнорирует, даже если они не none. | ||
| state строка |
| Когда present, гарантирует, что монитор существует.Когда absent, гарантирует, что монитор удален. | |
| target_password строка | Указывает пароль, если для целевого объекта требуется аутентификация. | ||
| target_username строка | Указывает имя пользователя, если для целевого объекта требуется аутентификация. | ||
| time_until_up целое число | Указывает количество секунд, которые необходимо ждать после того, как ресурс впервые правильно отреагировал на монитор, прежде чем установить для ресурса состояние «включено». В течение этого интервала все ответы от ресурса должны быть корректными. По истечении интервала ресурс помечается как «включен». Значение 0 означает, что ресурс помечается как включенный сразу после получения первого правильного ответа. | ||
| timeout целое число | Указывает количество секунд, в течение которых целевой объект имеет для ответа на запрос монитора. Если целевой объект отвечает в установленный период времени, он считается «включенным». Если целевой объект не отвечает в установленный период времени, он считается «выключенным». Если это значение установлено в 0 (ноль), система использует интервал из родительского монитора. Обратите внимание, что timeout и time_until_up совместно управляют тем, когда ресурс устанавливается в состояние «включено». | ||
| up_interval целое число | Указывает интервал, используемый системой для проверки состояния здоровья ресурса, когда ресурс включен. Если 0, система использует интервал, указанный в interval, для проверки состояния здоровья ресурса.В противном случае, вы можете указать другой интервал для проверки состояния здоровья ресурса, который находится в рабочем состоянии. | ||
| update_password строка |
| always будет обновлять пароли, если указан target_password.on_create будет устанавливать пароль только для вновь созданных мониторов. | |
Примечания
Примечание
- Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
- Требуется версия ПО BIG-IP >= 12.
- Модули F5 изменяют только рабочую конфигурацию продукта F5. Чтобы гарантировать, что конфигурация, специфичная для BIG-IP, сохранится на диске, обязательно включите хотя бы одну задачу, использующую модуль f5networks.f5_modules.bigip_config для сохранения рабочей конфигурации. Обратитесь к документации модуля для правильного использования модуля для сохранения текущей конфигурации.
Примеры
- name: Create an mysql monitor
bigip_monitor_mysql:
ip: 10.10.10.10
port: 10923
name: my_mysql_monitor
send: "SELECT status FROM v$instance"
recv: OPEN
recv_column: 2
recv_row: 1
database: primary1
target_username: bigip
target_password: secret
update_password: on_create
state: present
provider:
server: lb.mydomain.com
user: admin
password: secret
delegate_to: localhost
- name: Modify an mysql monitor
bigip_monitor_mysql:
name: my_mysql_monitor
recv_column: 4
recv_row: 3
database: primary2
state: present
provider:
server: lb.mydomain.com
user: admin
password: secret
delegate_to: localhost
- name: Remove mysql monitor
bigip_monitor_mysql:
state: absent
name: my_mysql_monitor
provider:
server: lb.mydomain.com
user: admin
password: secret
delegate_to: localhost
Значения возврата
Общие значения возврата документированы здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| app_service строка | changed | Сервис iApp, связанный с данным монитором. Пример: /Common/good_service.app/good_service |
| database строка | changed | Имя базы данных, к которой пытается получить доступ монитор. Пример: primary1 |
| debug булево | changed | Указывает, отправляет ли монитор сообщения об ошибках и дополнительную информацию в файл журнала, созданный и помеченный специально для этого монитора. |
| description строка | changed | Описание монитора. Пример: Важный монитор |
| interval целое число | changed | Новый интервал, с которым нужно выполнять проверку монитора. Пример: 2 |
| ip строка | changed | Новый IP-адрес определения IP/порта. Пример: 10.12.13.14 |
| manual_resume булево | changed | Указывает, автоматически ли система изменяет состояние ресурса на «включено» при следующей успешной проверке монитором. Пример: True |
| parent строка | changed | Родительский монитор. Пример: /Common/foo_mysql |
| port строка | changed | Псевдоним порта или сервиса для монитора, который нужно проверить от имени пулов или членов пулов, с которыми связан монитор. Пример: 80 |
| recv строка | changed | Текстовая строка, которую ищет монитор в возвращаемом ресурсе. Пример: OPEN |
| recv_column строка | changed | Столбец в базе данных, где должна находиться указанная строка. Пример: 2 |
| recv_row строка | changed | Строка в базе данных, где должна находиться указанная строка. Пример: 1 |
| send строка | changed | SQL-запрос, отправляемый монитором целевому объекту. Пример: SELECT status FROM v$instance |
| target_username строка | changed | Имя пользователя для контролируемого целевого объекта. Пример: bigip |
| time_until_up целое число | changed | Новое время, в течение которого система должна быть отмечена как «включена» после первого успешного ответа. Пример: 2 |
| timeout целое число | changed | Новый тайм-аут, в течение которого удалённая система должна ответить на запрос монитора. Пример: 10 |
| up_interval целое число | changed | Интервал, который система использует для выполнения проверки работоспособности, когда ресурс включен. |
Авторы
- Андрей Кащеев (@andreykashcheev)
© 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/f5networks/f5_modules/bigip_monitor_mysql_module.html
