bigip_pool_member - Управляет членами пулов F5 BIG-IP LTM
Новая версия с 1.4.
Краткое описание
- Управляет членами пулов F5 BIG-IP LTM через API iControl SOAP
Требования (к хосту, на котором выполняется модуль)
- bigsuds
Параметры
| параметр | обязательно | значение по умолчанию | варианты | примечания |
|---|---|---|---|---|
| connection_limit | нет | Предел подключений к члену пула. Установка значения 0 отключает ограничение. | ||
| description | нет | Описание члена пула | ||
| host | да | IP-адрес члена пула псевдонимы: address, name | ||
| monitor_state (добавлен в 2.0)
| нет |
| Установить состояние мониторинга для члена пула | |
| partition | нет | Common | Раздел | |
| password | да | Пароль учетной записи пользователя для подключения к BIG-IP. Этот параметр можно опустить, если переменная окружения F5_PASSWORD установлена. | ||
| pool | да | Имя пула. Пул должен существовать. | ||
| port | да | Порт члена пула | ||
| preserve_node (добавлен в 2.1)
| нет | нет |
| Когда состояние отсутствует, и член пула больше не упоминается в других пулах, по умолчанию удаляется неиспользуемый объект узла. Установка этого значения в 'да' отключает это поведение. |
| priority_group (добавлен в 2.4)
| нет | Устанавливает группу приоритетов для члена пула. | ||
| rate_limit | нет | Предел скорости члена пула (подключений в секунду). Установка значения 0 отключает ограничение. | ||
| ratio | нет | Весовой коэффициент члена пула. Допустимые значения от 1 до 100. Новые члены пула, если не указано иначе, имеют значение по умолчанию 1. | ||
| server | да | Хост BIG-IP. Этот параметр можно опустить, если переменная окружения F5_SERVER установлена. | ||
| server_port (добавлен в 2.2)
| нет | 443 | Порт сервера BIG-IP. Этот параметр можно опустить, если переменная окружения F5_SERVER_PORT установлена. | |
| session_state (добавлен в 2.0)
| нет |
| Установить новое состояние доступности сеанса для члена пула | |
| state | да | present |
| Состояние члена пула |
| user | да | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Этот параметр можно опустить, если переменная окружения F5_USER установлена. | ||
| validate_certs (добавлен в 2.0)
| нет | True |
| Если no, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых пользователем сайтах с самозаверяемыми сертификатами. Этот параметр можно опустить, если переменная окружения F5_VALIDATE_CERTS установлена. |
Примеры
- name: Add pool member
bigip_pool_member:
server: "lb.mydomain.com"
user: "admin"
password: "secret"
state: "present"
pool: "my-pool"
partition: "Common"
host: "{{ ansible_default_ipv4['address'] }}"
port: 80
description: "web server"
connection_limit: 100
rate_limit: 50
ratio: 2
delegate_to: localhost
- name: Modify pool member ratio and description
bigip_pool_member:
server: "lb.mydomain.com"
user: "admin"
password: "secret"
state: "present"
pool: "my-pool"
partition: "Common"
host: "{{ ansible_default_ipv4['address'] }}"
port: 80
ratio: 1
description: "nginx server"
delegate_to: localhost
- name: Remove pool member from pool
bigip_pool_member:
server: "lb.mydomain.com"
user: "admin"
password: "secret"
state: "absent"
pool: "my-pool"
partition: "Common"
host: "{{ ansible_default_ipv4['address'] }}"
port: 80
delegate_to: localhost
# The BIG-IP GUI doesn't map directly to the API calls for "Pool ->
# Members -> 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 pool member offline
bigip_pool_member:
server: "lb.mydomain.com"
user: "admin"
password: "secret"
state: "present"
session_state: "disabled"
monitor_state: "disabled"
pool: "my-pool"
partition: "Common"
host: "{{ ansible_default_ipv4['address'] }}"
port: 80
delegate_to: localhost
Примечания
Примечание
- Требуется версия ПО BIG-IP >= 11
- Необходим разработанный F5 модуль ‘bigsuds’ (см. http://devcentral.f5.com)
- Лучше всего запускать как local_action в вашем playbook
- Заменяет bigip_pool для управления членами пулов
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратной совместимости интерфейса.
Для получения помощи в разработке модулей, если вас это интересует, ознакомьтесь с Справочная информация по сообществу и участие в разработке, Тестирование 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_pool_member_module.html