bigip_node - Управляет узлами F5 BIG-IP LTM
Новая версия 1.4.
Описание
- Управляет узлами F5 BIG-IP LTM через API iControl SOAP
Требования (к хосту, на котором выполняется модуль)
- bigsuds
Параметры
| параметр | обязательно | по умолчанию | варианты | комментарии |
|---|---|---|---|---|
| описание | нет | Описание узла. | ||
| хост | да | IP-адрес узла. Обязательно, когда state=present и узел не существует. Ошибка при state=absent. псевдонимы: адрес, ip | ||
| monitor_state (добавлено в 1.9)
| нет |
| Устанавливает статус доступности мониторинга для узла | |
| monitor_type (добавлено в 2.2)
| нет |
| Тип правила мониторинга при мониторах > 1 | |
| monitors (добавлено в 2.2)
| нет | Список имен шаблонов мониторов. Всегда используйте полный путь к монитору. | ||
| имя | нет | Имя узла | ||
| раздел | нет | Common | Раздел | |
| пароль | да | Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Этот параметр можно опустить, если переменная среды F5_PASSWORD установлена. | ||
| quorum (добавлено в 2.2)
| нет | Значение кворума монитора, когда monitor_type — m_of_n | ||
| сервер | да | Хост BIG-IP. Этот параметр можно опустить, если переменная среды F5_SERVER установлена. | ||
| порт_сервера (добавлено в 2.2)
| нет | 443 | Порт сервера BIG-IP. Этот параметр можно опустить, если переменная среды F5_SERVER_PORT установлена. | |
| session_state (добавлено в 1.9)
| нет |
| Устанавливает новый статус доступности сессий для узла | |
| состояние | да | present |
| Состояние члена пула |
| пользователь | да | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Этот параметр можно опустить, если переменная среды F5_USER установлена. | ||
| validate_certs (добавлено в 2.0)
| нет | True |
| Если no, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых вами сайтах, использующих самозаверенные сертификаты. Этот параметр можно опустить, если переменная среды F5_VALIDATE_CERTS установлена. |
Примеры
- 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"
# Note that the BIG-IP automatically names the node using the
# IP address specified in previous play's host parameter.
# Future plays referencing this node no longer use the host
# parameter but instead use the name parameter.
# Alternatively, you could have specified a name with the
# name parameter when state=present.
- 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"
# The BIG-IP GUI doesn't map directly to the API calls for "Node ->
# General Properties -> State". The following states map to API monitor
# and session states.
#
# Enabled (all traffic allowed):
# monitor_state=enabled, session_state=enabled
# Disabled (only persistent or active connections allowed):
# monitor_state=enabled, session_state=disabled
# Forced offline (only active connections allowed):
# monitor_state=disabled, session_state=disabled
#
# See https://devcentral.f5.com/questions/icontrol-equivalent-call-for-b-node-down
- name: Force node offline
bigip_node:
server: "lb.mydomain.com"
user: "admin"
password: "mysecret"
state: "present"
session_state: "disabled"
monitor_state: "disabled"
partition: "Common"
name: "10.20.30.40"
Примечания
Примечание
- Требуется версия ПО BIG-IP >= 11
- Модуль ‘bigsuds’, разработанный F5, необходим (см. http://devcentral.f5.com)
- Лучше всего запускать как local_action в вашем playbook
Статус
Этот модуль помечен как предварительный, что означает, что его интерфейс не гарантируется обратной совместимостью.
Для получения помощи в разработке модулей, если вы так склонны, пожалуйста, прочитайте Информация о сообществе и участие в разработке, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/bigip_node_module.html