bigip_gtm_monitor_bigip – Управляет мониторами F5 BIG-IP GTM BIG-IP

Новая версия 2.6.

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

Описание

Управляет мониторами F5 BIG-IP GTM BIG-IP. Данный монитор используется GTM для мониторинга самих BIG-IP.

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

f5-sdk >= 3.0.16

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
aggregate_dynamic_ratios -		Варианты: none average-nodes sum-nodes average-members sum-members	Указывает, как система комбинирует значения модулей для создания пропорции (оценки) для операции балансировки нагрузки. Оценка представляет собой расчетную емкость модуля для обработки трафика. Средневзвешенные значения подходят для виртуальных серверов ускорителей веб-трафика или менеджеров безопасности приложений на стороне клиента. При создании нового монитора, если этот параметр не указан, используется значение по умолчанию `none`, что означает, что система не использует оценки в операции балансировки нагрузки. Когда `none`, указывает, что монитор игнорирует оценки узлов и членов пула. Когда `average-nodes`, указывает, что система усредняет динамические коэффициенты узлов, связанных с целевыми виртуальными серверами монитора, и возвращает это среднее значение в качестве оценки виртуальных серверов. Когда `sum-nodes`, указывает, что система суммирует оценки узлов, связанных с целевыми виртуальными серверами монитора, и использует это значение в операции балансировки нагрузки. Когда `average-members`, указывает, что система усредняет динамические коэффициенты членов пула, связанных с целевыми виртуальными серверами монитора, и возвращает это среднее значение в качестве оценки виртуальных серверов. Когда `sum-members`, указывает, что система суммирует оценки членов пула, связанных с целевыми виртуальными серверами монитора, и использует это значение в операции балансировки нагрузки.
ignore_down_response boolean		Варианты: no yes	Указывает, что монитор допускает более одной попытки зондирования за интервал. Когда `yes`, указывает, что монитор игнорирует ответы о недоступности в течение времени ожидания монитора. После того, как время ожидания монитора истекло, и система не получила ответ о доступности, система помечает объект как недоступный. Когда `no`, указывает, что монитор сразу помечает объект как недоступный при получении ответа о недоступности. При создании нового монитора, если этот параметр не задан, значение по умолчанию будет `no`.
interval -			Указывает частоту проверок монитора системой в секундах, когда ресурс недоступен или его статус неизвестен. При создании нового монитора, если этот параметр не указан, значение по умолчанию будет `30`. Это значение должно быть меньше значения `timeout`.
ip -			Часть IP-адреса в определении IP/порт. Если этот параметр не указан при создании нового монитора, значение по умолчанию будет '*'.
name - / обязательно			Имя монитора.
parent -		По умолчанию: "/Common/bigip"	Родительская шаблон этого шаблона монитора. После установки этого значения его нельзя изменить. По умолчанию это родительское значение `bigip` в разделе `Common`.
partition -		По умолчанию: "Common"	Раздел устройства для управления ресурсами.
password - / обязательно			Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_PASSWORD`. псевдонимы: pass, pwd
port -			Адрес порта в определении IP/порт. Если этот параметр не указан при создании нового монитора, значение по умолчанию будет '*'. Обратите внимание, что если вы указываете IP-адрес, необходимо указать значение от 1 до 65535.
provider - добавлен в 2.5		По умолчанию: null	Объект словаря, содержащий данные подключения.
	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 -	По умолчанию: 10	Указывает время ожидания в секундах для связи с сетевым устройством при подключении или отправке команд. Если время ожидания истечет до завершения операции, модуль выдаст ошибку.
	transport - / обязательно	Варианты: rest cli ←	Настраивает транспортное соединение для подключения к удаленному устройству.
	user - / обязательно		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, установив переменную среды `F5_USER`.
	validate_certs boolean	Варианты: no yes ←	Если `no`, сертификаты SSL не проверяются. Используйте только на сайтах, которыми вы управляете, с самозаверяющимися сертификатами. Вы можете опустить этот параметр, установив переменную среды `F5_VALIDATE_CERTS`.
server - / обязательно			Хост BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_SERVER`.
server_port - добавлен в 2.2		По умолчанию: 443	Порт сервера BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_SERVER_PORT`.
state -		Варианты: present ← absent	Когда `present`, гарантирует, что монитор существует. Когда `absent`, гарантирует удаление монитора.
timeout -			Указывает количество секунд, в течение которого целевой объект должен ответить на запрос монитора. Если целевой объект отвечает в течение заданного периода времени, он считается доступным. Если целевой объект не отвечает в течение заданного периода времени, он считается недоступным. Если это значение установлено в 0 (ноль), система использует интервал родительского монитора. При создании нового монитора, если этот параметр не задан, значение по умолчанию будет `90`.
user - / обязательно			Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, установив переменную среды `F5_USER`.

validate_certs

boolean

добавлено в 2.0

Варианты:

нет
да ←

Если no, сертификаты SSL не проверяются. Используйте это только на сайтах, контролируемых лично, с использованием самозаверяемых сертификатов.

Этот параметр можно опустить, задав переменную среды F5_VALIDATE_CERTS.

Примечания

Примечание

Требуется версия ПО BIG-IP >= 12
Дополнительную информацию о использовании Ansible для управления устройствами F5 Networks см. на https://www.ansible.com/integrations/networks/f5.
На хосте требуется пакет f5-sdk Python. Это так же просто, как pip install f5-sdk.
Требуется версия ПО BIG-IP >= 12.
Модули F5 изменяют только текущую конфигурацию продукта F5. Чтобы гарантировать, что специфичная для BIG-IP конфигурация сохранится на диске, убедитесь, что включён хотя бы один task, использующий модуль bigip_config для сохранения текущей конфигурации. Обратитесь к документации модуля для правильного использования модуля для сохранения текущей конфигурации.

Примеры

- name: Create BIG-IP Monitor
  bigip_gtm_monitor_bigip:
    state: present
    ip: 10.10.10.10
    server: lb.mydomain.com
    user: admin
    password: secret
    name: my_monitor
  delegate_to: localhost

- name: Remove BIG-IP Monitor
  bigip_gtm_monitor_bigip:
    state: absent
    server: lb.mydomain.com
    user: admin
    password: secret
    name: my_monitor
  delegate_to: localhost

- name: Add BIG-IP monitor for all addresses, port 514
  bigip_gtm_monitor_bigip:
    server: lb.mydomain.com
    user: admin
    port: 514
    password: secret
    name: my_monitor
  delegate_to: localhost

Значения возврата

Общие значения возврата документированы здесь, следующие поля уникальны для данного модуля:

Ключ	Возвращаемое значение	Описание
aggregate_dynamic_ratios строка	changed	Новая агрегированная информация для монитора. Пример: sum-members
ignore_down_response boolean	changed	Игнорировать ответ о недоступности или нет. Пример: True
interval целое число	changed	Новый интервал для проверки монитора. Пример: 2
ip строка	changed	Новый IP-адрес для определения IP/порта. Пример: 10.12.13.14
parent строка	changed	Новая родительская шаблон монитора. Пример: bigip
timeout целое число	changed	Новый таймаут для ответа удаленной системы на монитор. Пример: 10

Статус

Этот модуль не гарантирует обратную совместимость. [превью]
Этот модуль поддерживается партнёром Ansible. [сертифицировано]

Авторы

Tim Rupp (@caphrim007)

Подсказка

Если вы заметили какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/bigip_gtm_monitor_bigip_module.html