f5networks.f5_modules.bigip_gtm_pool – Управляет пулами F5 BIG-IP GTM

Примечание

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

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

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

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

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

Обзор

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
alternate_lb_method строка		Варианты: round-robin return-to-dns none ratio topology static-persistence global-availability virtual-server-capacity packet-rate drop-packet fallback-ip virtual-server-score	Режим балансировки нагрузки, к которому система обращается, если `preferred_lb_method` не смог выбрать пул.
availability_requirements словарь			Если активировано более одного монитора состояния, указывает количество мониторов, которые должны получить успешные ответы, чтобы ссылка считалась доступной.
	at_least целое число		Указывает минимальное количество активных мониторов состояния, которые должны получить успешные ответы, чтобы ссылка считалась активной. Этот параметр актуален только при использовании `type` типа `at_least`. Этот параметр будет проигнорирован, если используется тип `all` или `require`.
	number_of_probers целое число		Указывает количество зондирующих агентов, которые должны использоваться при проведении проверок. При создании нового виртуального сервера, если указан этот параметр, также должен быть указан параметр `number_of_probes`. Значение этого параметра должно быть больше или равно значению `number_of_probers`. Этот параметр актуален только при использовании `type` типа `require`. Этот параметр будет проигнорирован, если используется тип `all` или `at_least`.
	number_of_probes целое число		Указывает минимальное количество успешных проверок для объявления сервера активным. При создании нового виртуального сервера, если указан этот параметр, также должен быть указан параметр `number_of_probers`. Значение этого параметра должно быть меньше или равно значению `number_of_probers`. Этот параметр актуален только при использовании `type` типа `require`. Этот параметр будет проигнорирован, если используется тип `all` или `at_least`.
	type строка / обязательно	Варианты: all at_least require	Тип правила мониторинга, когда указан `monitors`. При создании нового пула, если этот параметр не указан, используется значение по умолчанию 'all'.
fallback_ip строка			Указывает IPv4 или IPv6 адрес сервера, на который система перенаправляет запросы, если не может использовать один из своих пулов. Обратите внимание, что система использует резервный IP-адрес только если выбран метод балансировки нагрузки `fallback_ip`.
fallback_lb_method строка		Варианты: round-robin return-to-dns ratio topology static-persistence global-availability virtual-server-capacity least-connections lowest-round-trip-time fewest-hops packet-rate cpu completion-rate quality-of-service kilobytes-per-second drop-packet fallback-ip virtual-server-score none	Режим балансировки нагрузки, к которому система обращается, если оба `preferred_lb_method` и `alternate_lb_method` не смогли выбрать пул.
max_answers_returned целое число			Указывает максимальное количество доступных виртуальных серверов, которые система отображает в ответе. Максимальное значение - 500.
members список / элементы=словарь			Члены, которые нужно назначить пулу. Порядок членов в списке соответствует порядку их отображения в пуле.
	server строка / обязательно		Имя сервера, к которому относится член пула.
	virtual_server строка / обязательно		Имя виртуального сервера, связанного с сервером, к которому относится член пула.
monitors список / элементы=строка			Указывает мониторы состояния, которые система в настоящее время использует для мониторинга этого ресурса. Если `availability_requirements.type` `require`, в списке `monitors` может быть только один монитор.
name строка / обязательно			Имя пула GTM.
partition строка		Значение по умолчанию: "Common"	Раздел устройства для управления ресурсами.
preferred_lb_method строка		Варианты: round-robin return-to-dns ratio topology static-persistence global-availability virtual-server-capacity least-connections lowest-round-trip-time fewest-hops packet-rate cpu completion-rate quality-of-service kilobytes-per-second drop-packet fallback-ip virtual-server-score	Режим балансировки нагрузки, который система пытается использовать в первую очередь.
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 enabled disabled	Состояние пула. Если `present`, гарантирует создание и активацию пула. Если `absent`, гарантирует удаление пула из системы. Если `enabled` или `disabled`, гарантирует активацию или деактивацию (соответственно) пула на удалённом устройстве.
ttl целое число			Указывает количество секунд, в течение которых IP-адрес, найденный ранее, считается действительным.
type строка		Варианты: a aaaa cname mx naptr srv	Тип пула GTM, который вы хотите создать. В версиях BIG-IP до 12-й включительно, этот параметр не требуется. В более поздних версиях BIG-IP, этот параметр является обязательным.

Примечания

Примечание

Поддержка версий TMOS ниже v12.x устарела для данного модуля и будет удалена в f5_modules 1.4.
Дополнительную информацию об использовании 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 pool
  bigip_gtm_pool:
    name: my_pool
    provider:
      user: admin
      password: secret
      server: lb.mydomain.com
  delegate_to: localhost

- name: Disable pool
  bigip_gtm_pool:
    state: disabled
    name: my_pool
    provider:
      user: admin
      password: secret
      server: lb.mydomain.com
  delegate_to: localhost

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

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

Ключ		Возвращаемое значение	Описание
alternate_lb_method строка		изменилось	Новый метод альтернативного балансирования нагрузки для пула. Пример: drop-packet
fallback_ip строка		изменилось	Новый резервный IP-адрес, используемый при балансировании нагрузки с помощью метода `fallback_ip`. Пример: 10.10.10.10
fallback_lb_method строка		изменилось	Новый метод резервного балансирования нагрузки для пула. Пример: fewest-hops
max_answers_returned целое число		изменилось	Новое значение Максимальное количество возвращенных ответов. Пример: 25
members сложное		изменилось	Список членов в пуле.
	server строка	изменилось	Имя части сервера члена.
	virtual_server строка	изменилось	Имя части виртуального сервера члена.
monitors список / элементы=строка		изменилось	Новый список мониторов для ресурса. Пример: ['/Common/monitor1', '/Common/monitor2']
preferred_lb_method строка		изменилось	Новый предпочтительный метод балансирования нагрузки для пула. Пример: topology

Авторы

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_pool_module.html