f5networks.f5_modules.bigip_monitor_mysql – Управляет мониторами BIG-IP MySQL
Примечание
Этот плагин входит в коллекцию f5networks.f5_modules (версия 1.6.0).
Для его установки используйте: 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/f5networks/f5_modules/bigip_monitor_mysql_module.html
