f5networks.f5_modules.bigip_gtm_monitor_tcp – Управляет мониторами F5 BIG-IP GTM TCP
Примечание
Этот плагин входит в коллекцию f5networks.f5_modules (версия 1.7.1).
Для установки используйте: ansible-galaxy collection install f5networks.f5_modules.
Для использования в книге задач укажите: f5networks.f5_modules.bigip_gtm_monitor_tcp.
Новое в версии 1.0.0: из f5networks.f5_modules
Обзор
- Управляет мониторами F5 BIG-IP GTM (теперь BIG-IP DNS) TCP.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| ignore_down_response boolean |
| Указывает, что монитор допускает более одной попытки зондирования за интервал. Когда yes, указывает, что монитор игнорирует ответы о снижении производительности в течение времени ожидания монитора. После достижения времени ожидания монитора без получения ответа о повышении производительности система отмечает объект как неисправный.Когда no, указывает, что монитор немедленно отмечает объект как неисправный, когда получает ответ о снижении производительности.При создании нового монитора, если этот параметр не указан, значение по умолчанию будет no. | |
| interval integer | Интервал, определяющий частоту выполнения экземпляра монитора этой шаблона. Если этот параметр не указан при создании нового монитора, значение по умолчанию будет 30. Это значение должно быть меньше значения timeout. | ||
| ip string | IP-адрес, являющийся частью определения IP/порт. Если этот параметр не указан при создании нового монитора, значение по умолчанию будет '*'. Если это значение — IP-адрес, необходимо указать число port. | ||
| name string / обязательно | Имя монитора. | ||
| parent string | Значение по умолчанию: "/Common/tcp" | Родительский шаблон этого шаблона монитора. После установки этого значения его нельзя изменить. По умолчанию это значение — родительский шаблон tcp на разделе Common. | |
| partition string | Значение по умолчанию: "Common" | Раздел устройства для управления ресурсами. | |
| port string | Порт, являющийся частью определения IP/порт. Если этот параметр не указан при создании нового монитора, значение по умолчанию будет '*'. Обратите внимание, что если используется IP-адрес, вы должны указать значение от 1 до 65535. | ||
| probe_timeout integer | Указывает количество секунд, после которого система отключает запрос зондирования на системе. При создании нового монитора, если этот параметр не указан, то значение по умолчанию будет 5. | ||
| provider dictionary добавлено в 1.0.0 f5networks.f5_modules | Объект словаря, содержащий данные подключения. | ||
| auth_provider string | Настраивает поставщика аутентификации для получения маркеров аутентификации от удаленного устройства. Этот параметр используется, когда работаете с устройствами BIG-IQ. | ||
| no_f5_teem boolean |
| Если yes, данные телеметрии TEEM не отправляются в F5.Вы можете опустить этот параметр, установив переменную среды F5_TEEM. | |
| password string / обязательно | Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, установив переменную среды F5_PASSWORD.псевдонимы: pass, pwd | ||
| server string / обязательно | Хост BIG-IP. Вы можете опустить этот параметр, установив переменную среды F5_SERVER. | ||
| server_port integer | Значение по умолчанию: 443 | Порт сервера BIG-IP. Вы можете опустить этот параметр, установив переменную среды F5_SERVER_PORT. | |
| timeout integer | Указывает время ожидания в секундах для связи с сетевым устройством для подключения или отправки команд. Если время ожидания превышено до завершения операции, модуль вернёт ошибку. | ||
| transport string |
| Настраивает транспортное соединение для использования при подключении к удалённому устройству. | |
| user string / обязательно | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь права администратора на устройстве. Вы можете опустить этот параметр, установив переменную среды F5_USER. | ||
| validate_certs boolean |
| Если no, сертификаты SSL не проверяются. Используйте это только на сайтах под своим контролем, использующих самозаверяющие сертификаты.Вы можете опустить этот параметр, установив переменную среды F5_VALIDATE_CERTS. | |
| receive string | Строка приёма для вызова монитора. | ||
| reverse boolean |
| Инструктирует систему отмечать целевой ресурс как неисправный при успешном тесте. Эта настройка полезна, например, если содержимое домашней страницы вашего веб-сайта динамичное и часто меняется, вы можете настроить обратный сервис проверки ECV, который ищет строку Error. Совпадение со строкой означает, что веб-сервер был неисправен. Для использования этого параметра необходимо указать значения для send и receive. | |
| send string | Строка отправления для вызова монитора. | ||
| state string |
| Когда present, гарантирует, что монитор существует.Когда absent, гарантирует, что монитор удален. | |
| timeout integer | Количество секунд, в течение которых узел или служба должны ответить на запрос монитора. Если целевой объект отвечает в заданный период времени, он считается активным. Если целевой объект не отвечает в заданный период времени, он считается неисправным. Вы можете изменить это число на любое желаемое, однако оно должно быть в 3 раза больше числа интервалов в секундах плюс 1 секунда. Если этот параметр не указан при создании нового монитора, значение по умолчанию будет 120. | ||
| transparent boolean |
| Указывает, работает ли монитор в прозрачном режиме. Монитор в прозрачном режиме перенаправляет трафик через связанных членов пула или узлы (обычно маршрутизатор или брандмауэр) на алиасированный пункт назначения (то есть, он проверяет комбинацию ip-port, указанную в мониторе).Если монитор не может успешно достичь алиасированного пункта назначения, член пула или узел, через который проходил трафик монитора, отмечается как неисправный. При создании нового монитора, если этот параметр не указан, то значение по умолчанию будет no. | |
Примечания
Примечание
- Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на https://www.ansible.com/integrations/networks/f5.
- Требуется версия ПО BIG-IP >= 12.
- Модули F5 изменяют только текущую конфигурацию продукта F5. Чтобы гарантировать, что конфигурация BIG-IP сохранится на диске, убедитесь, что в задаче используется по крайней мере один модуль, использующий модуль f5networks.f5_modules.bigip_config для сохранения текущей конфигурации. Обратитесь к документации модуля для правильного использования модуля для сохранения текущей конфигурации.
Примеры
- name: Create a GTM TCP monitor
bigip_gtm_monitor_tcp:
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 TCP Monitor
bigip_gtm_monitor_tcp:
name: my_monitor
state: absent
provider:
user: admin
password: secret
server: lb.mydomain.com
delegate_to: localhost
- name: Add TCP monitor for all addresses, port 514
bigip_gtm_monitor_tcp:
name: my_monitor
port: 514
provider:
user: admin
password: secret
server: lb.mydomain.com
delegate_to: localhost
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращённое значение | Описание |
|---|---|---|
| ignore_down_response boolean | изменённое | Игнорировать ли ответ об отключении. Пример: True |
| interval integer | изменённое | Новый интервал для проверки мониторинга. Пример: 2 |
| ip string | изменённое | Новый IP-адрес определения IP/порта. Пример: 10.12.13.14 |
| parent string | изменённое | Новая родительская шаблон мониторинга. Пример: tcp |
| port string | изменённое | Новый порт, на котором мониторинг проверяет ресурс. Пример: 8080 |
| probe_timeout integer | изменённое | Новый таймаут для проверки зондирования мониторинга системой. Пример: 10 |
| receive string | изменённое | Новая строка приёма для этого мониторинга. Пример: tcp строка для приёма |
| reverse boolean | изменённое | Новое значение для работы мониторинга в обратном режиме. |
| send string | изменённое | Новая строка отправки для этого мониторинга. Пример: tcp строка для отправки |
| timeout integer | изменённое | Новый таймаут для ответа удалённой системы на мониторинг. Пример: 10 |
| transparent boolean | изменённое | Новое значение для работы мониторинга в прозрачном режиме. |
Авторы
- Tim Rupp (@caphrim007)
- Wojciech Wypior (@wojtek0806)
© 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_gtm_monitor_tcp_module.html
