Модуль 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 | Указывает, выполняет ли группа трафика возврат к исходному устройству, заданному в Варианты:
|
auto_failback_time integer | Указывает, сколько секунд система ожидает, прежде чем выполнить возврат к исходному устройству, заданному в Допустимый диапазон значений: от |
ha_group string | Указывает настроенную После создания группы HA на устройстве и ее связывания с группой трафика необходимо создать группу HA и связать ее с той же группой трафика на каждом устройстве в группе устройств. Чтобы отключить метод переключения при сбое группы HA, задайте для этого параметра пустую строку ( Отключение группы HA вернет устройство к использованию метода Параметры |
ha_load_factor integer | Значение нагрузки, создаваемой группой трафика для системы относительно других групп трафика. Этот параметр действует только при использовании метода переключения при сбое Допустимый диапазон значений: от |
ha_order list / elements=string | Указывает порядок назначения устройств для переключения при сбое. Если вы настраиваете этот параметр, его необходимо настроить для каждой группы трафика в группе устройств. Значениями должны быть имена устройств, входящих в ранее настроенную группу переключения при сбое. Порядок указания устройств в аргументах этого параметра определяет порядок HA на устройстве. Это означает, что изменение порядка тех же элементов приведет к изменению конфигурации устройства. Чтобы отключить метод переключения при сбое с порядком HA, задайте для этого параметра пустую строку ( Отключение порядка HA вернет устройство к использованию метода Load Aware (по умолчанию), если также не настроен параметр Модуль добавит к именам устройств раздел. Поэтому можно указать имя в формате полного пути |
mac_address string | Указывает плавающий MAC-адрес (Media Access Control), связанный с плавающими IP-адресами, заданными для группы трафика. В первую очередь, маскирующий MAC-адрес уменьшает количество ARP-обменов или потерь пакетов при переключении при сбое. Маскирующий MAC-адрес гарантирует, что весь трафик, предназначенный для определенной группы трафика, после переключения при сбое достигнет доступного устройства. Это происходит потому, что маскирующий MAC-адрес перемещается на доступное устройство вместе с группой трафика. Без маскирующего MAC-адреса отправляющий узел должен определить MAC-адрес нового активного устройства: отправив ARP-запрос или используя gratuitous ARP от нового активного устройства. Чтобы сбросить MAC-адрес, задайте для этого параметра пустое значение ( |
name string / обязательный | Имя группы трафика. |
partition string | Раздел устройства для управления ресурсами. По умолчанию: |
provider dictionary добавлено в f5networks.f5_modules 1.0.0 | Объект dict, содержащий сведения о подключении. |
|
auth_provider string |
Настраивает поставщика аутентификации для получения токенов аутентификации с удаленного устройства. Этот параметр используется главным образом при работе с устройствами BIG-IQ. |
|
no_f5_teem boolean |
Если Этот параметр можно не указывать, задав переменную окружения Переменная Варианты:
|
|
password псевдонимы: pass, pwd string / обязательный |
Пароль учетной записи пользователя для подключения к BIG-IP или BIG-IQ. Этот параметр можно не указывать, задав переменную окружения |
|
server string / обязательный |
Узел BIG-IP или BIG-IQ. Этот параметр можно не указывать, задав переменную окружения |
|
server_port integer |
Порт сервера BIG-IP. Этот параметр можно не указывать, задав переменную окружения По умолчанию: |
|
timeout integer |
Задает время ожидания в секундах при обмене данными с сетевым устройством — при подключении или отправке команд. Если время ожидания истечет до завершения операции, модуль выдаст ошибку. |
|
transport string |
Настраивает транспортное соединение для подключения к удаленному устройству. Варианты:
|
|
user string / обязательный |
Имя пользователя для подключения к BIG-IP или BIG-IQ. У этого пользователя должны быть права администратора на устройстве. Этот параметр можно не указывать, задав переменную окружения |
|
validate_certs boolean |
Если Этот параметр можно не указывать, задав переменную окружения Варианты:
|
state string | Если Если Варианты:
|
Примечания
Примечание
- Дополнительную информацию об использовании 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 Пример: |
auto_failback_time integer | Указывает, сколько секунд система ожидает перед выполнением возврата. Возвращается: changed Пример: |
ha_group string | Настроенная группа HA, связанная с группой трафика. Возвращается: changed Пример: |
ha_load_factor integer | Значение нагрузки, создаваемой группой трафика для системы относительно других групп трафика. Возвращается: changed Пример: |
ha_order list / elements=string | Указывает порядок переключения устройств при сбое. Возвращается: changed Пример: |
mac_address string | Маскирующий MAC-адрес. Возвращается: changed Пример: |
Ссылки на коллекцию
© 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