f5networks.f5_modules.bigip_trunk – Управление каналами на BIG-IP
Примечание
Этот модуль входит в коллекцию f5networks.f5_modules (версия 1.6.0).
Для его установки используйте: ansible-galaxy collection install f5networks.f5_modules.
Для использования в плейбуке укажите: f5networks.f5_modules.bigip_trunk.
Добавлен в версии 1.0.0: модуля f5networks.f5_modules
Обзор
- Управляет каналами на BIG-IP.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| description строка | Описание канала. | ||
| frame_distribution_hash строка |
| Определяет основу для хеширования, используемого в качестве алгоритма распределения кадров. Система использует полученное хеширование для определения интерфейса, используемого для пересылки трафика. При создании нового канала, если этот параметр не указан, значение по умолчанию — source-destination-ip.Когда source-destination-mac, задается, что система основывает хеширование на совокупности MAC-адресов источника и назначения.Когда destination-mac, задается, что система основывает хеширование на MAC-адресе назначения.Когда source-destination-ip, задается, что система основывает хеширование на совокупности IP-адресов источника и назначения. | |
| interfaces список / элементы=строка | Интерфейсы, входящие в состав канала. Для очистки списка интерфейсов укажите пустой список. | ||
| lacp_enabled булево |
| Если yes, система поддерживает протокол агрегирования каналов (LACP), который контролирует канал, обмениваясь управляющими пакетами по участковым каналам для определения состояния каналов.Если LACP обнаружит неполадку в участковом канале, он удалит этот канал из агрегации. При создании нового канала, если этот параметр не указан, LACP no.LACP по умолчанию отключен для совместимости со старыми версиями. Если это не относится к вашей сети, рекомендуется включить LACP. | |
| lacp_mode строка |
| Определяет режим работы протокола агрегирования каналов (LACP), если LACP включён для канала. При создании нового канала, если этот параметр не указан, значение по умолчанию — active.При active, система периодически отправляет управляющие пакеты, независимо от того, запросил ли партнерскую систему.При passive, система отправляет управляющие пакеты только после получения запроса от партнерской системы. | |
| lacp_timeout строка |
| Определяет скорость отправки управляющих пакетов LACP системой. При создании нового канала, если этот параметр не указан, значение по умолчанию — long.При long, система отправляет пакет управления LACP каждые 30 секунд.При short, система отправляет пакет управления LACP каждую секунду. | |
| link_selection_policy строка |
| После настройки канала указывает политику, которую канал использует для определения того, какой участковый канал (интерфейс) может обрабатывать новый трафик. При создании нового канала, если значение не указано, значение по умолчанию — auto.При auto, система автоматически определяет, какие интерфейсы могут обрабатывать новый трафик. Для варианта auto участковые каналы должны иметь одинаковый тип среды и скорость.При maximum-bandwidth, система определяет, какие интерфейсы могут обрабатывать новый трафик на основе максимальной пропускной способности участников. | |
| name строка / обязательно | Указывает имя канала. | ||
| provider словарь добавлен в 1.0.0 f5networks.f5_modules | Объект словаря, содержащий данные подключения. | ||
| auth_provider строка | Настраивает поставщика аутентификации для получения маркеров аутентификации от удаленного устройства. Этот параметр действительно используется при работе с устройствами BIG-IQ. | ||
| no_f5_teem булево |
| Если yes, данные телеметрии TEEM не отправляются в F5.Можно опустить этот параметр, задав переменную среды F5_TEEM. | |
| password строка / обязательно | Пароль учетной записи пользователя, используемой для подключения к BIG-IP. Можно опустить этот параметр, задав переменную среды F5_PASSWORD.псевдонимы: pass, pwd | ||
| server строка / обязательно | Хост BIG-IP. Можно опустить этот параметр, задав переменную среды F5_SERVER. | ||
| server_port целое число | По умолчанию: 443 | Порт сервера BIG-IP. Можно опустить этот параметр, задав переменную среды F5_SERVER_PORT. | |
| timeout целое число | Устанавливает таймаут в секундах для связи с сетевым устройством при подключении или отправке команд. Если таймаут истекает до завершения операции, модуль вернёт ошибку. | ||
| transport строка |
| Настраивает транспортное соединение для подключения к удаленному устройству. | |
| user строка / обязательно | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Можно опустить этот параметр, задав переменную среды F5_USER. | ||
| validate_certs булево |
| Если no, сертификаты SSL не проверяются. Используйте только на сайтах, контролируемых лично, использующих самоподписанные сертификаты.Можно опустить этот параметр, задав переменную среды F5_VALIDATE_CERTS. | |
| qinq_ethertype сырой | Указывает значение ether-type, используемое для пакетов, обрабатываемых этим каналом, когда он является участником сети QinQ VLAN. Значение ether-type может быть задано любой строкой, содержащей корректное 16-битовое шестнадцатеричное число, или любым известным значением ether-type; 0x8100, 0x9100, 0x88a8.Этот параметр не поддерживается в виртуальных редакциях. Этот параметр всегда должен быть заключён в кавычки, чтобы предотвратить интерпретацию Ansible как шестнадцатеричного числа и преобразование в целое число. | ||
| state строка |
| При 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 trunk on hardware
bigip_trunk:
name: trunk1
interfaces:
- 1.1
- 1.2
link_selection_policy: maximum-bandwidth
frame_distribution_hash: destination-mac
lacp_enabled: yes
lacp_mode: passive
lacp_timeout: short
provider:
password: secret
server: lb.mydomain.com
user: admin
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| description string | изменённое | Описание магистрали. Пример: Моя магистраль |
| frame_distribution_hash string | изменённое | Хеш, используемый системой в качестве алгоритма распределения кадров. Пример: src-dst-ipport |
| interfaces list / elements=string | изменённое | Интерфейсы, которые являются частью магистрали. Пример: ['int1', 'int2'] |
| lacp_enabled boolean | изменённое | Поддерживает ли система протокол контроля агрегации каналов (LACP). Пример: True |
| lacp_mode string | изменённое | Режим работы LACP, если опция LACP включена для магистрали. Пример: active |
| lacp_timeout string | изменённое | Скорость, с которой система отправляет пакеты управления LACP. Пример: long |
| link_selection_policy string | изменённое | Политика LACP, используемая магистралью для определения, какой интерфейс-член может обрабатывать новые данные. Пример: auto |
| qinq_ethertype string | изменённое | Значение Ether-type, используемое для пакетов, обрабатываемых на этой магистрали, когда она является членом VLAN QinQ. Пример: 37120 |
Авторы
- Tim Rupp (@caphrim007)
- Wojciech Wypior (@wojtek0806)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/f5networks/f5_modules/bigip_trunk_module.html
