bigip_node – Управляет узлами F5 BIG-IP LTM

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

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

Описание

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

Требования

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

f5-sdk >= 3.0.16

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
адрес - добавлен в 2.2			IP-адрес узла. Он может быть IPv4 или IPv6. При создании нового узла необходимо указать один из `address` или `fqdn`. Этот параметр нельзя изменить после его установки. псевдонимы: ip, host
connection_limit - добавлен в 2.7			Предел подключений к узлу. Установка значения 0 отключает ограничение.
описание -			Указывает описательный текст, идентифицирующий узел. Вы можете удалить описание, указав пустую строку или специальное значение `none`.
dynamic_ratio - добавлен в 2.7			Число динамического коэффициента для узла. Используется для динамического распределения нагрузки. При создании нового узла, если этот параметр не указан, будет использоваться значение по умолчанию `1`.
fqdn - добавлен в 2.5			FQDN-имя узла. Это может быть любое имя, являющееся допустимым именем DNS согласно RFC 1123. Поэтому, допустимые символы — это "A" до "Z", "a" до "z", "0" до "9", дефис ("-") и точка (".") FQDN-имена должны содержать по крайней мере одну точку; отделяя хост от домена. Пример: `host.domain`. FQDN-имена должны заканчиваться буквой или цифрой. При создании нового узла необходимо указать один из `address` или `fqdn` . Этот параметр нельзя изменить после его установки. псевдонимы: имя_хоста
fqdn_address_type - добавлен в 2.6		Варианты: ipv4 ipv6 all	Указывает, разрешается ли FQDN узла до IPv4 или IPv6 адреса. При создании нового узла, если этот параметр не указан и `fqdn` указан, этот параметр будет иметь значение по умолчанию `ipv4`. Этот параметр нельзя изменить после его установки.
fqdn_auto_populate boolean добавлен в 2.6		Варианты: no yes	Указывает, автоматически ли система создает эфемерные узлы, используя IP-адреса, полученные при разрешении DNS-запроса для узла, определенного FQDN. Когда `yes`, система генерирует эфемерный узел для каждого IP-адреса, возвращаемого в ответ на DNS-запрос для FQDN узла. Кроме того, когда DNS-ответ указывает, что IP-адрес эфемерного узла больше не существует, система удаляет эфемерный узел. Когда `no`, система разрешает DNS-запрос для FQDN узла с единственным IP-адресом, связанным с FQDN. При создании нового узла, если этот параметр не указан и `fqdn` указан, этот параметр будет иметь значение по умолчанию `yes`. Этот параметр нельзя изменить после его установки.
fqdn_down_interval - добавлен в 2.6			Указывает интервал, в котором происходит запрос, когда DNS-сервер недоступен. Соответствующий монитор продолжает опрос, пока DNS-сервер не доступен. При создании нового узла, если этот параметр не указан и `fqdn` указан, этот параметр будет иметь значение по умолчанию `5`.
fqdn_up_interval - добавлен в 2.6			Указывает интервал, в котором происходит запрос, когда DNS-сервер доступен. Соответствующий монитор пытается запросить три раза и помечает сервер как недоступный, если нет ответа в течение трехкратного интервала значения, в секундах. Этот параметр принимает значение `ttl` для запроса на основе TTL FQDN. Интервал TTL по умолчанию аналогичен указанию `3600`. При создании нового узла, если этот параметр не указан и `fqdn` указан, этот параметр будет иметь значение по умолчанию `3600`.
monitor_type - добавлен в 1.3		Варианты: and_list m_of_n single	Тип правила мониторинга, когда `monitors` указан. При создании нового пула, если это значение не указано, будет использоваться значение по умолчанию 'and_list'. И `single` и `and_list` функционально идентичны, так как BIG-IP рассматривает все мониторы как «список». BIG-IP либо имеет список многих, либо список одного. Разница в дополнительных защитах, которые предоставляет `single`; именно в том, что он разрешает только один монитор.
monitors - добавлен в 2.2			Указывает правила мониторинга, которые в настоящее время используются системой для мониторинга этого узла.
имя - / обязательно			Указывает имя узла.
раздел - добавлен в 2.5		Значение по умолчанию: "Общие"	Раздел устройства для управления ресурсами.
пароль - / обязательно			Пароль учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_PASSWORD`. псевдонимы: pass, pwd
поставщик - добавлен в 2.5		Значение по умолчанию: null	Объект словаря, содержащий данные подключения.
	пароль - / обязательно		Пароль учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_PASSWORD`. псевдонимы: pass, pwd
	сервер - / обязательно		Хост BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_SERVER`.
	порт_сервера -	Значение по умолчанию: 443	Порт сервера BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_SERVER_PORT`.
	ssh_keyfile -		Указывает SSH-ключевой файл для аутентификации подключения к удаленному устройству. Этот аргумент используется только для транспортов cli. Вы можете опустить этот параметр, установив переменную среды `ANSIBLE_NET_SSH_KEYFILE`.
	timeout -	Значение по умолчанию: 10	Указывает время ожидания в секундах для связи с сетевым устройством при подключении или отправке команд. Если время ожидания истечет до завершения операции, модуль выдаст ошибку.
	transport - / обязательно	Варианты: rest cli ←	Настраивает транспортное соединение для использования при подключении к удаленному устройству.
	пользователь - / обязательно		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, установив переменную среды `F5_USER`.

	validate_certs boolean	Варианты: no yes ←	Если `no`, сертификаты SSL не проверяются. Используйте только на сайтах, контролируемых вами лично, с самозаверенными сертификатами. Вы можете опустить этот параметр, установив переменную окружения `F5_VALIDATE_CERTS`.
quorum - добавлен в 2.2			Отслеживать значение quorum, когда `monitor_type` равно `m_of_n`.
rate_limit - добавлен в 2.7			Предел скорости узла (соединения в секунду). Установка значения 0 отключает ограничение.
ratio - добавлен в 2.7			Вес коэффициента узла. Допустимые значения от 1 до 100. При создании нового узла, если этот параметр не указан, будет использовано значение по умолчанию `1`.
server - / обязательно			Хост BIG-IP. Вы можете опустить этот параметр, установив переменную окружения `F5_SERVER`.
server_port - добавлен в 2.2		По умолчанию: 443	Порт сервера BIG-IP. Вы можете опустить этот параметр, установив переменную окружения `F5_SERVER_PORT`.
state -		Варианты: present ← absent enabled disabled offline	Указывает текущее состояние узла. `enabled` (Разрешен весь трафик), указывает, что система отправляет трафик на этот узел независимо от состояния узла. `disabled` (Разрешены только постоянные или активные соединения), указывает, что узел может обрабатывать только постоянные или активные соединения. `offline` (Разрешены только активные соединения), указывает, что узел может обрабатывать только активные соединения. Во всех случаях, кроме `absent`, узел будет создан, если он еще не существует. Обращайте особое внимание при изменении статуса узла, FQDN которого не может быть разрешён. В таких ситуациях вы не сможете изменить его `state` на `disabled` или `offline`. Они останутся в состоянии Недоступен - Включен.
user - / обязательно			Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, установив переменную окружения `F5_USER`.
validate_certs boolean добавлен в 2.0		Варианты: no yes ←	Если `no`, сертификаты SSL не проверяются. Используйте только на сайтах, контролируемых вами лично, с самозаверенными сертификатами. Вы можете опустить этот параметр, установив переменную окружения `F5_VALIDATE_CERTS`.

Примечания

Примечание

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

Примеры

- name: Add node
  bigip_node:
    server: lb.mydomain.com
    user: admin
    password: secret
    state: present
    partition: Common
    host: 10.20.30.40
    name: 10.20.30.40
  delegate_to: localhost

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

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

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

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

- name: Add node by their FQDN
  bigip_node:
    server: lb.mydomain.com
    user: admin
    password: secret
    state: present
    partition: Common
    fqdn: foo.bar.com
    name: 10.20.30.40
  delegate_to: localhost

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

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

Ключ	Возвращаемое	Описание
description строка	changed и success	Изменённое значение для описания узла. Пример: Веб-сервер электронной коммерции в ORD
monitor_type строка	changed и success	Изменённое значение для monitor_type узла. Пример: m_of_n
monitors список	changed и success	Изменённый список мониторов для узла. Пример: ['icmp', 'tcp_echo']
quorum целое число	changed и success	Изменённое значение для quorum узла. Пример: 1
session строка	changed и success	Изменённое значение для внутреннего сеанса узла. Пример: user-disabled
state строка	changed и success	Изменённое значение для внутреннего состояния узла. Пример: m_of_n

Статус

Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
Этот модуль поддерживается партнером 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_node_module.html