f5networks.f5_modules.bigip_gtm_monitor_tcp модуль — Управляет мониторами TCP F5 BIG-IP GTM

Примечание

Этот модуль входит в коллекцию f5networks.f5_modules (версия 1.31.0).

У вас, возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить её установку, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install f5networks.f5_modules.

Чтобы использовать её в книге задач, укажите: f5networks.f5_modules.bigip_gtm_monitor_tcp.

Новое в f5networks.f5_modules 1.0.0

Описание
Параметры
Примечания
Примеры
Возвращаемые значения

Описание

Управляет мониторами TCP F5 BIG-IP GTM (теперь BIG-IP DNS).

Параметры

Параметр	Комментарии
ignore_down_response boolean	Указывает, что монитор допускает более одной попытки запроса в течение интервала. Когда `true`, монитор игнорирует ответы о неработоспособности в течение времени ожидания монитора. После того, как время ожидания монитора истекает без получения ответа о работоспособности, система помечает объект как неработоспособный. Когда `false`, монитор сразу помечает объект как неработоспособный при получении ответа о неработоспособности. При создании нового монитора, если этот параметр не указан, значение по умолчанию равно `false`. Варианты: `false` `true`
interval integer	Интервал, определяющий частоту выполнения монитора этого шаблона. Если этот параметр не указан при создании нового монитора, значение по умолчанию равно 30. Это значение должно быть меньше значения `timeout`.
ip string	Часть IP-адреса определения IP/порта. Если этот параметр не указан при создании нового монитора, значение по умолчанию равно ‘*’. Если это значение — IP-адрес, необходимо указать числовой `port`.
name string / обязательно	Имя монитора.
parent string	Родительский шаблон этого шаблона монитора. После установки этого значения его нельзя изменить. По умолчанию это родительское значение `tcp` в раздела `Common`. По умолчанию: `"/Common/tcp"`
partition string	Раздел устройства для управления ресурсами. По умолчанию: `"Common"`
port string	Адрес порта, часть определения IP/порта. Если этот параметр не указан при создании нового монитора, значение по умолчанию равно ‘*’. Обратите внимание, что при использовании IP-адреса необходимо указать значение от 1 до 65535.
probe_timeout integer	Указывает количество секунд, после которого система прекращает запрос проверки к системе. При создании нового монитора, если этот параметр не указан, значение по умолчанию равно `5`.
... (rest of the table) ...

END_OF_DOCUMENT_MARKER

validate_certs boolean	Если `no`, сертификаты SSL не будут проверены. Используйте только на сайтах, контролируемых лично, с самозаверяющими сертификатами. Вы можете опустить этот параметр, установив переменную окружения `F5_VALIDATE_CERTS`. Выбор: `false` `true` ← (по умолчанию)
receive string	Строка получения для вызова монитора.
reverse boolean	Указывает системе отметить целевой ресурс как недоступный, когда тест успешен. Этот параметр полезен, например, если содержимое домашней страницы вашего веб-сайта динамичное и часто меняется, вы можете настроить обратный ECV-сервис проверки, который ищет строку Error. Совпадение с этой строкой означает, что веб-сервер был недоступен. Для использования этого параметра необходимо указать значения для `send` и `receive`. Выбор: `false` `true`
send string	Строка отправки для вызова монитора.
state string	Если `present`, гарантирует существование монитора. Если `absent`, гарантирует удаление монитора. Выбор: `"present"` ← (по умолчанию) `"absent"`
timeout integer	Количество секунд, в течение которого узел или служба должны ответить на запрос монитора. Если целевой ресурс отвечает в установленный период, он считается доступным. Если целевой ресурс не отвечает в установленный период, он считается недоступным. Вы можете изменить это число на любое, но оно должно быть в 3 раза больше числа интервалов в секундах плюс 1 секунда. Если этот параметр не указан при создании нового монитора, значение по умолчанию — 120.
transparent boolean	Указывает, работает ли монитор в прозрачном режиме. Монитор в прозрачном режиме направляет трафик через ассоциированные члены пула или узлы (обычно маршрутизатор или брандмауэр) к алиасному пункту назначения (то есть он исследует комбинацию `ip`-`port`, указанную в мониторе). Если монитор не может успешно достичь алиасного пункта назначения, член пула или узел, через который был отправлен трафик монитора, помечается как недоступный. При создании нового монитора, если этот параметр не указан, значение по умолчанию — `false`. Выбор: `false` `true`

Примечания

Примечание

Дополнительную информацию об использовании 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	Игнорировать ответ о недоступности или нет. Возвращаемое значение: changed Пример: `true`
interval integer	Новый интервал для проверки монитора. Возвращаемое значение: changed Пример: `2`
ip string	Новый IP-адрес определения IP/порт. Возвращаемое значение: changed Пример: `"10.12.13.14"`
parent string	Новая родительская шаблон монитора. Возвращаемое значение: changed Пример: `"tcp"`
port string	Новый порт, на котором монитор проверяет ресурс. Возвращаемое значение: changed Пример: `"8080"`
probe_timeout integer	Новый тайм-аут для проверки монитора. Возвращаемое значение: changed Пример: `10`
receive string	Новый строка приема для этого монитора. Возвращаемое значение: changed Пример: `"tcp string to receive"`
reverse boolean	Новое значение для работы монитора в обратном режиме. Возвращаемое значение: changed Пример: `false`
send string	Новая отправляемая строка для этого монитора. Возвращаемое значение: changed Пример: `"tcp string to send"`
timeout integer	Новый тайм-аут, в течение которого удаленная система должна ответить монитору. Возвращаемое значение: changed Пример: `10`
transparent boolean	Новое значение для работы монитора в прозрачном режиме. Возвращаемое значение: changed Пример: `false`

Авторы

Tim Rupp (@caphrim007)
Wojciech Wypior (@wojtek0806)

Ссылки на сборку

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/f5networks/f5_modules/bigip_gtm_monitor_tcp_module.html