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

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

Обзор
- Требования
Параметры
Примечания
Примеры
Значения возврата
Статус
- Автор

Обзор

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

Требования

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

f5-sdk >= 3.0.9

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
address (добавлено в 2.2)			IP-адрес узла. Он может быть IPv4 или IPv6. При создании нового узла необходимо указать один из `address` или `fqdn`. Этот параметр нельзя обновить после его задания. Псевдонимы: ip, host
description			Указывает описательный текст, идентифицирующий узел.
fqdn (добавлено в 2.5)			FQDN-имя узла. Это может быть любое имя, являющееся допустимым именем DNS RFC 1123. Таким образом, можно использовать только символы "A" до "Z", "a" до "z", "0" до "9", дефис ("-") и точку ("."). FQDN-имена должны содержать хотя бы одну точку, отделяющую хост от домена. Пример: `host.domain`. FQDN-имена должны заканчиваться буквой или цифрой. При создании нового узла необходимо указать один из `address` или `fqdn`. Этот параметр нельзя обновить после его задания. Псевдонимы: имя_хоста
monitor_type (добавлено в 1.3)		Варианты: and_list m_of_n single	Тип правила мониторинга, когда указан `monitors`. При создании нового пула, если это значение не указано, по умолчанию используется 'and_list'. И `single` и `and_list` функционально идентичны, поскольку BIG-IP рассматривает все мониторы как "список". BIG-IP либо имеет список из многих, либо список из одного. Разница в дополнительных мерах, которые предоставляет `single`, а именно, в том, что он допускает только один монитор.
monitors (добавлено в 2.2)			Указывает правила мониторинга состояния, используемые системой для мониторинга этого узла.
name обязательно			Указывает имя узла.
partition (добавлено в 2.5)		По умолчанию: Common	Раздел устройства для управления ресурсами.
password обязательно			Пароль учетной записи пользователя для подключения к BIG-IP. Можно опустить этот параметр, если переменная среды `F5_PASSWORD` установлена. Псевдонимы: pass, pwd
provider (добавлено в 2.5)		По умолчанию: None	Объект словаря, содержащий данные подключения.
	ssh_keyfile		Указывает файл ключа SSH для аутентификации подключения к удаленному устройству. Этот аргумент используется только для транспортов cli. Если значение не указано в задаче, используется значение переменной среды `ANSIBLE_NET_SSH_KEYFILE`.
	timeout	По умолчанию: 10	Указывает тайм-аут в секундах для связи с сетевым устройством при подключении или отправке команд. Если тайм-аут истечет до завершения операции, модуль вернёт ошибку.
	server обязательно		Хост BIG-IP. Можно опустить этот параметр, если переменная среды `F5_SERVER` установлена.
	user обязательно		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Можно опустить этот параметр, если переменная среды `F5_USER` установлена.
	server_port	По умолчанию: 443	Порт сервера BIG-IP. Можно опустить этот параметр, если переменная среды `F5_SERVER_PORT` установлена.
	password обязательно		Пароль учетной записи пользователя для подключения к BIG-IP. Можно опустить этот параметр, если переменная среды `F5_PASSWORD` установлена. Псевдонимы: pass, pwd
	validate_certs	Варианты: no yes ←	Если `no`, сертификаты SSL не будут проверены. Используйте только на сайтах, контролируемых вами, с самозаверяющимися сертификатами. Можно опустить этот параметр, если переменная среды `F5_VALIDATE_CERTS` установлена.
	transport обязательно	Варианты: rest cli ←	Настраивает транспортное соединение, используемое при подключении к удалённому устройству.
quorum (добавлено в 2.2)			Значение кворума мониторинга, когда `monitor_type` равно `m_of_n`.
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 (добавлено в 2.0)		Варианты: no yes ←	Если `no`, сертификаты SSL не будут проверены. Используйте только на сайтах, контролируемых вами, с самозаверяющимися сертификатами. Можно опустить этот параметр, если переменная среды `F5_VALIDATE_CERTS` установлена.

Примечания

Примечание

Требуется пакет netaddr Python на хосте. Это так же легко, как pip install netaddr
Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
Требуется пакет f5-sdk Python на хосте. Это так же просто, как pip install f5-sdk.

Примеры

- 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 строка	изменено и успешно	Изменено значение для описания узла. Пример: E-Commerce webserver в ORD
monitor_type строка	изменено и успешно	Изменено значение для типа монитора узла. Пример: m_of_n
monitors список	изменено и успешно	Изменен список мониторов для узла. Пример: ['icmp', 'tcp_echo']
quorum целое число	изменено и успешно	Изменено значение для кворума узла. Пример: 1
session строка	изменено и успешно	Изменено значение для внутренней сессии узла. Пример: user-disabled
state строка	изменено и успешно	Изменено значение для внутреннего состояния узла. Пример: m_of_n

Статус

Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость.

Автор

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.5/modules/bigip_node_module.html