bigip_pool - Управляет пулами LTM F5 BIG-IP.
- Описание
- Требования (к хосту, на котором выполняется модуль)
- Параметры
- Примеры
- Возвращаемые значения
- Примечания
Описание
- Управляет пулами F5 BIG-IP LTM через API iControl REST.
Требования (к хосту, на котором выполняется модуль)
- f5-sdk
Параметры
| параметр | обязательно | значение по умолчанию | выбор | комментарии |
|---|---|---|---|---|
| описание (добавлено в 2.3)
| нет | Указывает описательный текст, идентифицирующий пул. | ||
| хост | нет | IP-адрес члена пула. псевдонимы: адрес | ||
| метод_балансировки (добавлено в 1.3)
| нет |
| Метод балансировки нагрузки. При создании нового пула, если это значение не указано, будет использовано значение по умолчанию round-robin. | |
| тип_монитора (добавлено в 1.3)
| нет |
| Тип правила мониторинга, когда monitors > 1. | |
| мониторы (добавлено в 1.3)
| нет | Список имен шаблонов мониторов. Если раздела не указано как часть имени монитора, то будет использовано значение по умолчанию partition. | ||
| имя | да | Имя пула псевдонимы: пул | ||
| пароль | да | Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Этот параметр можно опустить, если переменная среды F5_PASSWORD установлена. | ||
| порт | нет | Порт члена пула. | ||
| кворум (добавлено в 1.3)
| нет | Значение кворума мониторинга, когда monitor_type является m_of_n. | ||
| повторные_попытки_перевыбора (добавлено в 2.2)
| нет | Устанавливает количество попыток системы связаться с членом пула после пассивного сбоя. | ||
| сервер | да | Хост BIG-IP. Этот параметр можно опустить, если переменная среды F5_SERVER установлена. | ||
| порт_сервера (добавлено в 2.2)
| нет | 443 | Порт сервера BIG-IP. Этот параметр можно опустить, если переменная среды F5_SERVER_PORT установлена. | |
| действие_при_отключении_сервиса (добавлено в 1.3)
| нет |
| Устанавливает действие, которое должно быть выполнено, когда узел в пуле выходит из строя. | |
| время_медленного_наращивания (добавлено в 1.3)
| нет | Устанавливает время наращивания (в секундах) для постепенного наращивания нагрузки на недавно добавленных или обнаруженных работающих членах пула. | ||
| пользователь | да | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь права администратора на устройстве. Этот параметр можно опустить, если переменная среды F5_USER установлена. | ||
| проверять_сертификаты (добавлено в 2.0)
| нет | True |
| Если no, сертификаты SSL не будут проверены. Это следует использовать только на сайтах, контролируемых лично, использующих самозаверяющие сертификаты. Этот параметр можно опустить, если переменная среды F5_VALIDATE_CERTS установлена. |
Примеры
- name: Create pool
bigip_pool:
server: "lb.mydomain.com"
user: "admin"
password: "secret"
state: "present"
name: "my-pool"
partition: "Common"
lb_method: "least_connection_member"
slow_ramp_time: 120
delegate_to: localhost
- name: Modify load balancer method
bigip_pool:
server: "lb.mydomain.com"
user: "admin"
password: "secret"
state: "present"
name: "my-pool"
partition: "Common"
lb_method: "round_robin"
delegate_to: localhost
- name: Add pool member
bigip_pool:
server: "lb.mydomain.com"
user: "admin"
password: "secret"
state: "present"
name: "my-pool"
partition: "Common"
host: "{{ ansible_default_ipv4['address'] }}"
port: 80
delegate_to: localhost
- name: Remove pool member from pool
bigip_pool:
server: "lb.mydomain.com"
user: "admin"
password: "secret"
state: "absent"
name: "my-pool"
partition: "Common"
host: "{{ ansible_default_ipv4['address'] }}"
port: 80
delegate_to: localhost
- name: Delete pool
bigip_pool:
server: "lb.mydomain.com"
user: "admin"
password: "secret"
state: "absent"
name: "my-pool"
partition: "Common"
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения описаны здесь Возвращаемые значения, следующие поля уникальны для данного модуля:
| имя | описание | возвращаемое | тип | пример |
|---|---|---|---|---|
| описание | Описание, заданное для пула. | изменённое | строка | Пул веб-серверов |
| хост | IP-адрес члена пула, включенного в пул. | изменённое | строка | 10.10.10.10 |
| метод_балансировки | Метод балансировки нагрузки, заданный для пула. | изменённое | строка | round-robin |
| тип_монитора | Контакт, который был установлен в дата-центре. | изменённое | строка | admin@root.local |
| мониторы | Мониторы, заданные для пула. | изменённое | список | ['/Common/http', '/Common/gateway_icmp'] |
| порт | Порт члена пула, включённого в пул. | изменённое | целое число | 80 |
| кворум | Кворум, который был установлен для пула. | изменённое | целое число | 2 |
| повторные_попытки_перевыбора | Новое значение, установленное для количества попыток связаться с членом. | изменённое | целое число | 10 |
| действие_при_отключении_сервиса | Действие при отключении сервиса, установленное для пула. | изменённое | строка | reset |
| время_медленного_наращивания | Новое значение, установленное для времени медленного наращивания. | изменённое | целое число | 500 |
Примечания
Примечание
- Требуется версия ПО BIG-IP >= 11.
- Необходим модуль F5, разработанный компанией F5, «F5-SDK» (https://github.com/F5Networks/f5-common-python).
- Лучше всего запускать как local_action в вашем playbook.
Статус
Этот модуль помечен как preview, что означает, что он не гарантирует обратную совместимость интерфейса.
Для получения помощи в разработке модулей, если вы так решили, пожалуйста, прочитайте Информацию о сообществе и вклад, Тестирование 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_module.html