Spec-Zone.ru › Ansible 2.4

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)
нет
  • enabled
  • disabled
Установить состояние мониторинга для члена пула
partition
нет Common
Раздел
password
да
Пароль учетной записи пользователя для подключения к BIG-IP. Этот параметр можно опустить, если переменная окружения F5_PASSWORD установлена.
pool
да
Имя пула. Пул должен существовать.
port
да
Порт члена пула
preserve_node
(добавлен в 2.1)
нет нет
  • True
  • False
Когда состояние отсутствует, и член пула больше не упоминается в других пулах, по умолчанию удаляется неиспользуемый объект узла. Установка этого значения в 'да' отключает это поведение.
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)
нет
  • enabled
  • disabled
Установить новое состояние доступности сеанса для члена пула
state
да present
  • present
  • absent
Состояние члена пула
user
да
Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Этот параметр можно опустить, если переменная окружения F5_USER установлена.
validate_certs
(добавлен в 2.0)
нет True
  • True
  • False
Если 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API