f5networks.f5_modules.bigip_node – Управление узлами F5 BIG-IP LTM

Примечание

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

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

Для использования в playbook, укажите: f5networks.f5_modules.bigip_node.

Нововведение в версии 1.0.0: f5networks.f5_modules

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

Краткое описание

Управление узлами F5 BIG-IP LTM.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
address string			IP-адрес узла. Это может быть IPv4 или IPv6. При создании нового узла необходимо указать один из параметров `address` или `fqdn`. Этот параметр не может быть изменен после его установки. псевдонимы: ip, host
availability_requirements dictionary			Если активировано более одного монитора работоспособности, указывает количество мониторов работоспособности, которые должны получить успешные ответы, чтобы связь считалась доступной.
	at_least integer		Указывает минимальное количество активных мониторов работоспособности, которые должны быть успешными, прежде чем связь будет считаться активной. Этот параметр актуален только при использовании `type` типа `at_least`. Этот параметр будет игнорироваться, если используется тип `all`.
	type string / required	Варианты: all at_least	Тип правила монитора, когда указан `monitors`. При создании нового пула, если это значение не указано, будет использоваться значение по умолчанию 'all'.
connection_limit integer			Лимит подключений к узлу. Установка этого значения в `0` отключает ограничение.
description string			Указывает описательный текст, который идентифицирует узел. Вы можете удалить описание, указав либо пустую строку, либо специальное значение `none`.
dynamic_ratio integer			Число динамического коэффициента для узла. Используется для балансировки нагрузки с динамическим коэффициентом. При создании нового узла, если этот параметр не указан, будет использоваться значение по умолчанию `1`.
fqdn string			FQDN-имя узла. Это может быть любое имя, являющееся допустимым именем DNS RFC 1123. Следовательно, могут использоваться только символы "A" - "Z", "a" - "z", "0" - "9", дефис ("-") и точка ("."). FQDN-имена должны содержать хотя бы одну точку; разделяющую хост и домен. Например, `host.domain`. FQDN-имена должны заканчиваться буквой или цифрой. При создании нового узла необходимо указать один из параметров `address` или `fqdn`. Этот параметр не может быть изменен после его установки. псевдонимы: hostname
fqdn_address_type string		Варианты: ipv4 ipv6 all	Указывает, разрешается ли FQDN узла в адрес IPv4 или IPv6. При создании нового узла, если этот параметр не указан, и указан `fqdn`, этот параметр будет установлен по умолчанию в `ipv4`. Этот параметр не может быть изменен после его установки.
fqdn_auto_populate boolean		Варианты: no yes	Указывает, создает ли система автоматически эфемерные узлы, используя IP-адреса, возвращаемые разрешением DNS-запроса для узла, определенного FQDN. Когда `yes`, система создает эфемерный узел для каждого IP-адреса, возвращаемого в ответ на DNS-запрос для FQDN узла. Кроме того, когда DNS-ответ указывает, что IP-адрес эфемерного узла больше не существует, система удаляет эфемерный узел. Когда `no`, система разрешает DNS-запрос для FQDN узла с одним IP-адресом, связанным с FQDN. При создании нового узла, если этот параметр не указан, и указан `fqdn`, этот параметр будет установлен по умолчанию в `yes`. Этот параметр не может быть изменен после его установки.
fqdn_down_interval integer			Указывает интервал, в течение которого происходит запрос, когда DNS-сервер не работает. Соответствующий монитор продолжает опрос, пока DNS-сервер не работает. При создании нового узла, если этот параметр не указан, и указан `fqdn`, этот параметр будет установлен по умолчанию в `5`.
fqdn_up_interval string			Указывает интервал, в течение которого происходит запрос, когда DNS-сервер работает. Соответствующий монитор пытается выполнить проверку три раза и помечает сервер как неработающий, если нет ответа в течение трехкратного значения интервала в секундах. Этот параметр принимает значение `ttl` для запроса на основе TTL FQDN. Интервал TTL по умолчанию аналогичен указанию `3600`. При создании нового узла, если этот параметр не указан, и указан `fqdn`, этот параметр будет установлен по умолчанию в `3600`.
monitor_type string		Варианты: and_list m_of_n single	Тип правила монитора, когда указан `monitors`. При создании нового пула, если это значение не указано, будет использоваться значение по умолчанию 'and_list'. Параметры `single` и `and_list` функционально идентичны, поскольку BIG-IP рассматривает все мониторы как "список". BIG-IP имеет либо список из многих, либо список из одного. Их различие заключается в дополнительных средствах защиты, которые предоставляет `single`; а именно, что он позволяет только один монитор.
monitors list / elements=string			Указывает мониторы работоспособности, которые система в настоящее время использует для мониторинга этого узла.
name string / required			Указывает имя узла.
partition string		Значение по умолчанию: "Common"	Раздел устройства для управления ресурсами.
provider dictionary добавлено в 1.0.0 of f5networks.f5_modules			Объект dict, содержащий данные подключения.
	auth_provider string		Настраивает поставщика аутентификации для получения маркеров аутентификации от удаленного устройства. Этот параметр используется при работе с устройствами BIG-IQ.
	no_f5_teem boolean	Варианты: no yes	Если `yes`, данные телеметрии TEEM не отправляются в F5. Вы можете опустить этот параметр, установив переменную среды `F5_TEEM`.
	password string / required		Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_PASSWORD`. псевдонимы: pass, pwd
	server string / required		Хост BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_SERVER`.
	server_port integer	Значение по умолчанию: 443	Порт сервера BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_SERVER_PORT`.
	timeout integer		Указывает время ожидания в секундах для связи с сетевым устройством для подключения или отправки команд. Если время ожидания истекает до завершения операции, модуль выдаст ошибку.
	transport string	Варианты: rest ←	Настраивает транспортное соединение, которое будет использоваться при подключении к удаленному устройству.
	user string / required		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь права администратора на устройстве. Вы можете опустить этот параметр, установив переменную среды `F5_USER`.
	validate_certs boolean	Варианты: no yes ←	Если `no`, SSL-сертификаты не проверяются. Используйте это только на лично контролируемых сайтах, использующих самозаверяющие сертификаты. Вы можете опустить этот параметр, установив переменную среды `F5_VALIDATE_CERTS`.
quorum integer			Значение кворума монитора, когда `monitor_type` равен `m_of_n`.
rate_limit integer			Лимит скорости узла (подключений в секунду). Установка этого значения в `0` отключает ограничение.
ratio integer			Весовой коэффициент узла. Допустимые значения находятся в диапазоне от 1 до 100. При создании нового узла, если этот параметр не указан, будет использоваться значение по умолчанию `1`.

state

string

Choices:

present ←
absent
enabled
disabled
offline

Указывает текущее состояние узла. enabled (Разрешен весь трафик), указывает, что система отправляет трафик на этот узел независимо от его состояния. disabled (Разрешены только постоянные или активные соединения), указывает, что узел может обрабатывать только постоянные или активные соединения. offline (Разрешены только активные соединения), указывает, что узел может обрабатывать только активные соединения. Во всех случаях, кроме absent, узел будет создан, если он ещё не существует.

Будьте особенно осторожны при изменении состояния узла, FQDN которого не может быть разрешён. Эти ситуации отключают вашу возможность изменять их state на disabled или offline. Они останутся в состоянии *Недоступно - Включено*.

Примечания

Примечание

Для получения дополнительной информации об использовании Ansible для управления устройствами F5 Networks см. https://www.ansible.com/integrations/networks/f5.
Требуется версия программного обеспечения BIG-IP >= 12.
Модули F5 изменяют только рабочую конфигурацию продукта F5. Чтобы гарантировать сохранение конфигурации BIG-IP на диске, обязательно включите хотя бы одну задачу, которая использует модуль f5networks.f5_modules.bigip_config для сохранения рабочей конфигурации. Ознакомьтесь с документацией модуля для правильного использования модуля для сохранения вашей рабочей конфигурации.

Примеры

- name: Add node
  bigip_node:
    host: 10.20.30.40
    name: 10.20.30.40
    provider:
      server: lb.mydomain.com
      user: admin
      password: secret
  delegate_to: localhost

- name: Add node with a single 'ping' monitor
  bigip_node:
    host: 10.20.30.40
    name: mytestserver
    monitors:
      - /Common/icmp
    provider:
      server: lb.mydomain.com
      user: admin
      password: secret
  delegate_to: localhost

- name: Modify node description
  bigip_node:
    name: 10.20.30.40
    description: Our best server yet
    provider:
      server: lb.mydomain.com
      user: admin
      password: secret
  delegate_to: localhost

- name: Delete node
  bigip_node:
    state: absent
    name: 10.20.30.40
    provider:
      server: lb.mydomain.com
      user: admin
      password: secret
  delegate_to: localhost

- name: Force node offline
  bigip_node:
    state: disabled
    name: 10.20.30.40
    provider:
      server: lb.mydomain.com
      user: admin
      password: secret
  delegate_to: localhost

- name: Add node by their FQDN
  bigip_node:
    fqdn: foo.bar.com
    name: foobar.net
    provider:
      server: lb.mydomain.com
      user: admin
      password: secret
  delegate_to: localhost

Возвращаемые значения

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

Ключ	Возвращено	Описание
description string	changed and success	Изменённое значение для описания узла. Пример: E-Commerce webserver in ORD
monitor_type string	changed and success	Изменённое значение для monitor_type узла. Пример: m_of_n
monitors list / elements=string	changed and success	Изменённый список мониторов для узла. Пример: ['icmp', 'tcp_echo']
quorum integer	changed and success	Изменённое значение для кворума узла. Пример: 1
session string	changed and success	Изменённое значение для внутреннего сеанса узла. Пример: user-disabled
state string	changed and success	Изменённое значение для внутреннего состояния узла. Пример: m_of_n

Авторы

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