Spec-Zone.ru › Ansible

Модуль f5networks.f5_modules.bigip_device_traffic_group — управление группами трафика на BIG-IP

Примечание

Этот модуль входит в коллекцию f5networks.f5_modules (версия 1.39.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install f5networks.f5_modules.

Чтобы использовать коллекцию в плейбуке, укажите: f5networks.f5_modules.bigip_device_traffic_group.

Добавлено в f5networks.f5_modules 1.0.0

  • Краткое описание
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Краткое описание

  • Поддерживает управление группами трафика и их атрибутами на BIG-IP.

Параметры

Параметр

Комментарии

auto_failback

boolean

Указывает, выполняет ли группа трафика возврат к исходному устройству, заданному в ha_order.

Варианты:

  • false
  • true

auto_failback_time

integer

Указывает, сколько секунд система ожидает, прежде чем выполнить возврат к исходному устройству, заданному в ha_order.

Допустимый диапазон значений: от 0 - 300 включительно.

ha_group

string

Указывает настроенную HA group, которую нужно связать с группой трафика.

После создания группы HA на устройстве и ее связывания с группой трафика необходимо создать группу HA и связать ее с той же группой трафика на каждом устройстве в группе устройств.

Чтобы отключить метод переключения при сбое группы HA, задайте для этого параметра пустую строку ("").

Отключение группы HA вернет устройство к использованию метода Load Aware (по умолчанию), если также не настроен параметр ha_order.

Параметры auto_failback и auto_failback_time несовместимы с ha_group.

ha_load_factor

integer

Значение нагрузки, создаваемой группой трафика для системы относительно других групп трафика.

Этот параметр действует только при использовании метода переключения при сбое Load Aware.

Допустимый диапазон значений: от 1 - 1000 включительно.

ha_order

list / elements=string

Указывает порядок назначения устройств для переключения при сбое.

Если вы настраиваете этот параметр, его необходимо настроить для каждой группы трафика в группе устройств.

Значениями должны быть имена устройств, входящих в ранее настроенную группу переключения при сбое.

Порядок указания устройств в аргументах этого параметра определяет порядок HA на устройстве. Это означает, что изменение порядка тех же элементов приведет к изменению конфигурации устройства.

Чтобы отключить метод переключения при сбое с порядком HA, задайте для этого параметра пустую строку ("").

Отключение порядка HA вернет устройство к использованию метода Load Aware (по умолчанию), если также не настроен параметр ha_group.

Модуль добавит к именам устройств раздел. Поэтому можно указать имя в формате полного пути /Common/bigip1 или только строку с именем bigip1.

mac_address

string

Указывает плавающий MAC-адрес (Media Access Control), связанный с плавающими IP-адресами, заданными для группы трафика.

В первую очередь, маскирующий MAC-адрес уменьшает количество ARP-обменов или потерь пакетов при переключении при сбое.

Маскирующий MAC-адрес гарантирует, что весь трафик, предназначенный для определенной группы трафика, после переключения при сбое достигнет доступного устройства. Это происходит потому, что маскирующий MAC-адрес перемещается на доступное устройство вместе с группой трафика.

Без маскирующего MAC-адреса отправляющий узел должен определить MAC-адрес нового активного устройства: отправив ARP-запрос или используя gratuitous ARP от нового активного устройства.

Чтобы сбросить MAC-адрес, задайте для этого параметра пустое значение ("").

name

string / обязательный

Имя группы трафика.

partition

string

Раздел устройства для управления ресурсами.

По умолчанию: "Common"

provider

dictionary

добавлено в f5networks.f5_modules 1.0.0

Объект dict, содержащий сведения о подключении.

auth_provider

string

Настраивает поставщика аутентификации для получения токенов аутентификации с удаленного устройства.

Этот параметр используется главным образом при работе с устройствами BIG-IQ.

no_f5_teem

boolean

Если yes, телеметрические данные TEEM не отправляются в F5.

Этот параметр можно не указывать, задав переменную окружения F5_TELEMETRY_OFF.

Переменная F5_TEEM, использовавшаяся ранее, устарела, поскольку ее название было неясным.

Варианты:

  • false ← (по умолчанию)
  • true

password

псевдонимы: pass, pwd

string / обязательный

Пароль учетной записи пользователя для подключения к BIG-IP или BIG-IQ.

Этот параметр можно не указывать, задав переменную окружения F5_PASSWORD.

server

string / обязательный

Узел BIG-IP или BIG-IQ.

Этот параметр можно не указывать, задав переменную окружения F5_SERVER.

server_port

integer

Порт сервера BIG-IP.

Этот параметр можно не указывать, задав переменную окружения F5_SERVER_PORT.

По умолчанию: 443

timeout

integer

Задает время ожидания в секундах при обмене данными с сетевым устройством — при подключении или отправке команд. Если время ожидания истечет до завершения операции, модуль выдаст ошибку.

transport

string

Настраивает транспортное соединение для подключения к удаленному устройству.

Варианты:

  • "rest" ← (по умолчанию)

user

string / обязательный

Имя пользователя для подключения к BIG-IP или BIG-IQ. У этого пользователя должны быть права администратора на устройстве.

Этот параметр можно не указывать, задав переменную окружения F5_USER.

validate_certs

boolean

Если no, SSL-сертификаты не проверяются. Используйте этот параметр только на контролируемых вами ресурсах с самоподписанными сертификатами.

Этот параметр можно не указывать, задав переменную окружения F5_VALIDATE_CERTS.

Варианты:

  • false
  • true ← (по умолчанию)

state

string

Если present, гарантирует, что группа трафика существует.

Если absent, гарантирует, что группа трафика удалена.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

Примечания

Примечание

  • Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
  • Требуется BIG-IP версии >= 12.
  • Модули F5 изменяют только текущую конфигурацию продукта F5. Чтобы сохранить конфигурацию BIG-IP на диске, обязательно включите хотя бы одну задачу, использующую модуль f5networks.f5_modules.bigip_config для сохранения текущей конфигурации. Правильное использование модуля для сохранения текущей конфигурации описано в его документации.

Примеры

- name: Create a traffic group
  bigip_device_traffic_group:
    name: foo1
    state: present
    provider:
      user: admin
      password: secret
      server: lb.mydomain.com
  delegate_to: localhost

- name: Create a traffic group with ha_group failover
  bigip_device_traffic_group:
    name: foo2
    state: present
    ha_group: foo_HA_grp
    provider:
      user: admin
      password: secret
      server: lb.mydomain.com
  delegate_to: localhost

- name: Create a traffic group with ha_order failover
  bigip_device_traffic_group:
    name: foo3
    state: present
    ha_order:
      - /Common/bigip1.lab.local
      - /Common/bigip2.lab.local
    auto_failback: true
    auto_failback_time: 40
    provider:
      user: admin
      password: secret
      server: lb.mydomain.com
  delegate_to: localhost

- name: Change traffic group ha_order to ha_group
  bigip_device_traffic_group:
    name: foo3
    state: present
    ha_group: foo_HA_grp
    ha_order: ""
    auto_failback: false
    provider:
      user: admin
      password: secret
      server: lb.mydomain.com
  delegate_to: localhost

- name: Remove traffic group
  bigip_device_traffic_group:
    name: foo
    state: absent
    provider:
      user: admin
      password: secret
      server: lb.mydomain.com
  delegate_to: localhost

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже приведены поля, уникальные для этого модуля:

Ключ

Описание

auto_failback

boolean

Указывает, выполняет ли группа трафика возврат к исходному устройству, заданному в ha_order.

Возвращается: changed

Пример: true

auto_failback_time

integer

Указывает, сколько секунд система ожидает перед выполнением возврата.

Возвращается: changed

Пример: 60

ha_group

string

Настроенная группа HA, связанная с группой трафика.

Возвращается: changed

Пример: "foo_HA_grp"

ha_load_factor

integer

Значение нагрузки, создаваемой группой трафика для системы относительно других групп трафика.

Возвращается: changed

Пример: 20

ha_order

list / elements=string

Указывает порядок переключения устройств при сбое.

Возвращается: changed

Пример: ["/Common/bigip1", "/Common/bigip2"]

mac_address

string

Маскирующий MAC-адрес.

Возвращается: changed

Пример: "02:01:d7:93:35:08"

Авторы

  • Tim Rupp (@caphrim007)
  • Wojciech Wypior (@wojtek0806)

Ссылки на коллекцию

  • Отслеживание проблем
  • Домашняя страница
  • Репозиторий (исходный код)

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/f5networks/f5_modules/bigip_device_traffic_group_module.html

Spec-Zone.ru

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