Spec-Zone.ru › Ansible 2.4

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

  • Описание
  • Требования (к хосту, на котором выполняется модуль)
  • Параметры
  • Примеры
  • Возвращаемые значения
  • Примечания
    • Статус

Описание

  • Управляет пулами F5 BIG-IP LTM через API iControl REST.

Требования (к хосту, на котором выполняется модуль)

  • f5-sdk

Параметры

параметр обязательно значение по умолчанию выбор комментарии
описание
(добавлено в 2.3)
нет
Указывает описательный текст, идентифицирующий пул.
хост
нет
IP-адрес члена пула.
псевдонимы: адрес
метод_балансировки
(добавлено в 1.3)
нет
  • dynamic-ratio-member
  • dynamic-ratio-node
  • fastest-app-response
  • fastest-node
  • least-connections-member
  • least-connections-node
  • least-sessions
  • observed-member
  • observed-node
  • predictive-member
  • predictive-node
  • ratio-least-connections-member
  • ratio-least-connections-node
  • ratio-member
  • ratio-node
  • ratio-session
  • round-robin
  • weighted-least-connections-member
  • weighted-least-connections-nod
Метод балансировки нагрузки. При создании нового пула, если это значение не указано, будет использовано значение по умолчанию round-robin.
тип_монитора
(добавлено в 1.3)
нет
  • and_list
  • m_of_n
Тип правила мониторинга, когда 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)
нет
  • none
  • reset
  • drop
  • reselect
Устанавливает действие, которое должно быть выполнено, когда узел в пуле выходит из строя.
время_медленного_наращивания
(добавлено в 1.3)
нет
Устанавливает время наращивания (в секундах) для постепенного наращивания нагрузки на недавно добавленных или обнаруженных работающих членах пула.
пользователь
да
Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь права администратора на устройстве. Этот параметр можно опустить, если переменная среды F5_USER установлена.
проверять_сертификаты
(добавлено в 2.0)
нет True
  • True
  • False
Если 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

Spec-Zone.ru

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