f5networks.f5_modules.bigip_gtm_monitor_firepass – Управляет мониторами F5 BIG-IP GTM FirePass

Примечание

Этот плагин входит в коллекцию f5networks.f5_modules (версия 1.6.0).

Для его установки используйте: ansible-galaxy collection install f5networks.f5_modules.

Для использования в плейбуке укажите: f5networks.f5_modules.bigip_gtm_monitor_firepass.

Новое в версии 1.0.0: модуля f5networks.f5_modules

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

Описание

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
cipher_list строка			Указывает список шифров для данного монитора. Элементы в списке шифров разделяются двоеточием `:`. При создании нового монитора, если этот параметр не указан, используется список по умолчанию `HIGH:!ADH`.
concurrency_limit целое число			Указывает максимальный процент лицензированных подключений, при котором монитор отмечает систему Secure Access Manager как активную. Например, значение 95 процентов означает, что монитор отмечает систему Secure Access Manager как активную до тех пор, пока не будет использовано 95 процентов лицензированных подключений. Когда количество используемых лицензированных подключений превышает 95 процентов, монитор отмечает систему Secure Access Manager как неактивную. При создании нового монитора, если этот параметр не указан, значение по умолчанию `95`.
ignore_down_response логическое значение		Варианты: no yes	Указывает, позволяет ли монитор более одной попытки зондирования за интервал. Когда `yes`, монитор игнорирует ответы о неработоспособности в течение времени ожидания монитора. После истечения времени ожидания монитора без получения ответа об активности система отмечает объект как неактивный. Когда `no`, монитор сразу же отмечает объект как неактивный при получении ответа о неработоспособности. При создании нового монитора, если параметр не указан, значение по умолчанию `no`.
interval целое число			Интервал, указывающий, как часто экземпляр монитора данной шаблона будет выполняться. Если этот параметр не указан при создании нового монитора, значение по умолчанию 30. Это значение должно быть меньше значения `timeout`.
ip строка			IP-адрес, часть определения IP/порт. Если этот параметр не указан при создании нового монитора, значение по умолчанию '*'. Если это значение — IP-адрес, необходимо указать `port` число.
max_load_average целое число			Указывает число, которое монитор использует для маркировки системы Secure Access Manager как активной или неактивной. Система сравнивает значение Max Load Average с усреднённой нагрузкой системы Secure Access Manager за одну минуту. Когда средняя нагрузка системы Secure Access Manager попадает в заданный диапазон Max Load Average, монитор отмечает систему Secure Access Manager как активную. Когда среднее значение превышает установленное значение, монитор отмечает систему как неактивную. При создании нового монитора, если этот параметр не указан, значение по умолчанию `12`.
name строка / обязательно			Имя монитора.
parent строка		По умолчанию: "/Common/firepass_gtm"	Родительский шаблон данного шаблона монитора. После установки этого значения его нельзя изменить. По умолчанию это родительский элемент `tcp` на разделе `Common`.
partition строка		По умолчанию: "Common"	Раздел устройства для управления ресурсами.
port строка			Адрес порта, часть определения IP/порт. Если этот параметр не указан при создании нового монитора, значение по умолчанию '*'. Обратите внимание, что если указан IP-адрес, должно быть указано значение от 1 до 65535.
probe_timeout целое число			Указывает количество секунд, по истечении которых система отменяет запрос зондирования к системе. При создании нового монитора, если этот параметр не указан, значение по умолчанию `5`.
provider словарь добавлен в версии 1.0.0 модуля f5networks.f5_modules			Объект словаря, содержащий данные подключения.
	auth_provider строка		Настраивает поставщика аутентификации для получения маркеров аутентификации от удаленного устройства. Этот параметр используется при работе с устройствами BIG-IQ.
	no_f5_teem логическое значение	Варианты: no yes	Если `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 строка	Варианты: rest ←	Настраивает транспортное соединение, используемое при подключении к удаленному устройству.
	user строка / обязательно		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, задав переменную среды `F5_USER`.
	validate_certs логическое значение	Варианты: no yes ←	Если `no`, сертификаты SSL не проверяются. Используйте только на контролируемых вами сайтах с самозаверяющими сертификатами. Вы можете опустить этот параметр, задав переменную среды `F5_VALIDATE_CERTS`.
state строка		Варианты: present ← absent	Если `present`, гарантирует существование монитора. Если `absent`, гарантирует удаление монитора.
target_password строка			Указывает пароль, если контролируемый целевой объект требует аутентификации.
target_username строка			Указывает имя пользователя, если контролируемый целевой объект требует аутентификации.
timeout целое число			Количество секунд, в течение которых узел или служба должны ответить на запрос монитора. Если целевой объект отвечает в заданный период времени, он считается активным. Если целевой объект не отвечает в течение заданного периода времени, он считается неактивным. Вы можете изменить это значение на любое число, но оно должно быть в 3 раза больше интервала плюс 1 секунда. Если этот параметр не указан при создании нового монитора, значение по умолчанию 90.
update_password строка		Варианты: always ← on_create	`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 a GTM FirePass monitor
  bigip_gtm_monitor_firepass:
    name: my_monitor
    ip: 1.1.1.1
    port: 80
    state: present
    provider:
      user: admin
      password: secret
      server: lb.mydomain.com
  delegate_to: localhost

- name: Remove FirePass Monitor
  bigip_gtm_monitor_firepass:
    name: my_monitor
    state: absent
    provider:
      user: admin
      password: secret
      server: lb.mydomain.com
  delegate_to: localhost

- name: Add FirePass monitor for all addresses, port 514
  bigip_gtm_monitor_firepass:
    name: my_monitor
    port: 514
    provider:
      user: admin
      password: secret
      server: lb.mydomain.com
  delegate_to: localhost

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

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

Ключ	Возвращаемое значение	Описание
cipher_list строка	changed	Новое значение списка шифров. Пример: +3DES:+kEDH
concurrency_limit целое число	changed	Новое значение ограничения одновременности. Пример: 95
ignore_down_response булево	changed	Игнорировать ответ о недоступности или нет. Пример: True
interval целое число	changed	Новый интервал выполнения проверки монитора. Пример: 2
ip строка	changed	Новый IP адрес определения IP/порта. Пример: 10.12.13.14
max_load_average целое число	changed	Новое значение максимальной средней нагрузки. Пример: 12
parent строка	changed	Новый родительский шаблон монитора. Пример: firepass_gtm
port строка	changed	Новый порт, на котором монитор проверяет ресурс. Пример: 8080
probe_timeout целое число	changed	Новый тайм-аут для проверки монитора системой. Пример: 10
timeout целое число	changed	Новый тайм-аут, в течение которого удаленная система должна ответить монитору. Пример: 10

Авторы

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.10/collections/f5networks/f5_modules/bigip_gtm_monitor_firepass_module.html