bigip_gtm_monitor_http – Управляет мониторами F5 BIG-IP GTM http
Новая в версии 2.6.
Описание
- Управляет мониторами F5 BIG-IP GTM http.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| ignore_down_response boolean |
| Указывает, что монитор допускает более одной попытки запроса на проверку работоспособности за интервал. В случае yes, указывает, что монитор игнорирует ответы о недоступности в течение времени ожидания монитора. По истечении времени ожидания монитора, если система не получает ответ об активном состоянии, система помечает объект как недоступный.В случае no, указывает, что монитор сразу же помечает объект как недоступный при получении ответа о недоступности.При создании нового монитора, если этот параметр не указан, значение по умолчанию будет no. | |
| interval целое число | Интервал, указывающий, как часто экземпляр монитора этой шаблона будет выполняться. Если этот параметр не указан при создании нового монитора, значение по умолчанию будет 30. Это значение должно быть меньше значения timeout. | ||
| ip строка | Часть IP-адреса в определении IP/порт. Если этот параметр не указан при создании нового монитора, значение по умолчанию будет '*'. Если это значение — IP-адрес, то должно быть указано значение типа port. | ||
| name строка / обязательно | Имя монитора. | ||
| parent строка | Значение по умолчанию: "/Common/http" | Родительская шаблон монитора. После установки этого значения, его нельзя изменить. По умолчанию это значение — родитель tcp на разделе Common. | |
| partition строка | Значение по умолчанию: "Common" | Раздел устройства для управления ресурсами. | |
| port строка | Адрес порта в определении IP/порт. Если этот параметр не указан при создании нового монитора, значение по умолчанию будет '*'. Обратите внимание, что при указании IP-адреса, должно быть указано значение от 1 до 65535. | ||
| probe_timeout целое число | Указывает количество секунд, по истечении которых система отменяет запрос на проверку работоспособности к системе. При создании нового монитора, если этот параметр не указан, значение по умолчанию будет 5. | ||
| provider словарь добавлен в 2.5 | Объект словаря, содержащий сведения о подключении. | ||
| auth_provider строка | Настраивает поставщика аутентификации для получения маркеров аутентификации от удаленного устройства. Этот параметр используется при работе с устройствами BIG-IQ. | ||
| password строка / обязательно | Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Этот параметр можно опустить, установив переменную среды F5_PASSWORD.псевдонимы: pass, pwd | ||
| server строка / обязательно | Хост BIG-IP. Этот параметр можно опустить, установив переменную среды F5_SERVER. | ||
| server_port целое число | Значение по умолчанию: 443 | Порт сервера BIG-IP. Этот параметр можно опустить, установив переменную среды F5_SERVER_PORT. | |
| ssh_keyfile путь | Указывает файл SSH-ключа для аутентификации подключения к удаленному устройству. Этот параметр используется только для транспортов cli. Этот параметр можно опустить, установив переменную среды ANSIBLE_NET_SSH_KEYFILE. | ||
| timeout целое число | Указывает время ожидания в секундах для взаимодействия с сетевым устройством при подключении или отправке команд. Если время ожидания превышено до завершения операции, модуль выдаст ошибку. | ||
| transport строка |
| Настраивает транспортное подключение для подключения к удаленному устройству. | |
| user строка / обязательно | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Этот параметр можно опустить, установив переменную среды F5_USER. | ||
| validate_certs boolean |
| Если no, сертификаты SSL не проверяются. Используйте только на сайтах, контролируемых вами, с самоподписанными сертификатами.Этот параметр можно опустить, установив переменную среды F5_VALIDATE_CERTS. | |
| receive строка | Строка приема для вызова монитора. | ||
| reverse boolean |
| Указывает системе помечать целевой ресурс как недоступный, когда тест выполнен успешно. Эта настройка полезна, например, если содержимое домашней страницы вашего веб-сайта динамично и часто меняется, вы можете настроить обратный ECV-проверочный сервис, который ищет строку "Error". Совпадение с этой строкой означает, что веб-сервер был недоступен. Для использования этого параметра необходимо указать значения send и receive. | |
| send строка | Строка отправки для вызова монитора. При создании нового монитора, если этот параметр не указан, будет использовано значение по умолчанию GET /\r\n. | ||
| state строка |
| Если present, гарантирует, что монитор существует.Если absent, гарантирует удаление монитора. | |
| target_password строка | Указывает пароль, если целевой объект требует аутентификации. | ||
| target_username строка | Указывает имя пользователя, если целевой объект требует аутентификации. | ||
| timeout целое число | Количество секунд, в течение которых узел или служба должны ответить на запрос монитора. Если цель отвечает в установленный период времени, она считается доступной. Если цель не отвечает в установленный период времени, она считается недоступной. Вы можете изменить это число на любое желаемое число, однако оно должно быть в 3 раза больше интервала в секундах плюс 1 секунда. Если этот параметр не указан при создании нового монитора, значение по умолчанию будет 120. | ||
| transparent boolean |
| Указывает, работает ли монитор в прозрачном режиме. Монитор в прозрачном режиме направляет трафик через ассоциированные члены пула или узлы (обычно маршрутизатор или брандмауэр) к указанному пункту назначения (то есть, он проверяет комбинацию ip-port указанную в мониторе).Если монитор не может успешно достичь указанного пункта назначения, член пула или узел, через который отправлялся трафик монитора, помечается как недоступный. При создании нового монитора, если этот параметр не указан, значение по умолчанию будет no. | |
| update_password строка |
| always будет обновлять пароли, если target_password указано.on_create будет устанавливать пароль только для вновь созданных мониторов. | |
Примечания
Примечание
- Для получения дополнительной информации об использовании Ansible для управления устройствами F5 Networks см. https://www.ansible.com/integrations/networks/f5.
- Требуется версия программного обеспечения BIG-IP >= 12.
- Модули F5 изменяют только рабочую конфигурацию продукта F5. Чтобы убедиться, что конфигурация, специфичная для BIG-IP, сохранится на диске, необходимо включить по крайней мере одну задачу, использующую модуль bigip_config для сохранения рабочей конфигурации. Обратитесь к документации модуля для правильного использования модуля для сохранения текущей конфигурации.
Примеры
- name: Create a GTM HTTP monitor
bigip_gtm_monitor_http:
name: my_monitor
ip: 1.1.1.1
port: 80
send: my send string
receive: my receive string
state: present
provider:
user: admin
password: secret
server: lb.mydomain.com
delegate_to: localhost
- name: Remove HTTP Monitor
bigip_gtm_monitor_http:
name: my_monitor
state: absent
provider:
user: admin
password: secret
server: lb.mydomain.com
delegate_to: localhost
- name: Add HTTP monitor for all addresses, port 514
bigip_gtm_monitor_http:
name: my_monitor
port: 514
provider:
user: admin
password: secret
server: lb.mydomain.com
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращённое значение | Описание |
|---|---|---|
| ignore_down_response boolean | changed | Игнорировать или нет ответ «down». Пример: True |
| interval integer | changed | Новый интервал выполнения проверки монитора. Пример: 2 |
| ip string | changed | Новый IP-адрес определения IP/порта. Пример: 10.12.13.14 |
| parent string | changed | Новая родительская шаблон монитора. Пример: http |
| port string | changed | Новый порт, на котором монитор проверяет ресурс. Пример: 8080 |
| probe_timeout integer | changed | Новый таймаут, в течение которого система будет ожидать ответа от зонда монитора. Пример: 10 |
| receive string | changed | Новая строка приема для данного монитора. Пример: tcp строка для приема |
| reverse boolean | changed | Новое значение для того, работает ли монитор в обратном режиме. |
| send string | changed | Новая строка отправления для данного монитора. Пример: tcp строка для отправки |
| timeout integer | changed | Новый таймаут, в течение которого удалённая система должна ответить на запрос монитора. Пример: 10 |
| transparent boolean | changed | Новое значение для того, работает ли монитор в прозрачном режиме. |
Статус
- Гарантируется, что данный модуль не будет иметь обратной совместимости. [превью]
- Данный модуль поддерживается партнёром Ansible. [сертифицировано]
Авторы
- Tim Rupp (@caphrim007)
- Wojciech Wypior (@wojtek0806)
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/bigip_gtm_monitor_http_module.html
