f5networks.f5_modules.bigip_trunk – Управление магистралями на BIG-IP
Примечание
Этот плагин входит в состав коллекции f5networks.f5_modules (версия 1.7.1).
Для его установки используйте: 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, используемое для пакетов, обрабатываемых в этой магистрали, когда она является членом в VLAN QinQ. Значение 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-типа, используемое для пакетов, обрабатываемых на этом стволе, когда он является членом VLAN QinQ. Пример: 37120 |
Авторы
- Tim Rupp (@caphrim007)
- Wojciech Wypior (@wojtek0806)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/f5networks/f5_modules/bigip_trunk_module.html
