bigip_trunk – Управление каналами на BIG-IP
Новое в версии 2.6.
Описание
- Управляет каналами на BIG-IP.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| description строка добавлено в 2.7 | Описание канала. | ||
| 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 каждые 1 секунду. | |
| link_selection_policy строка |
| Указывает политику, которую канал использует для определения, какой членский канал (интерфейс) может обрабатывать новый трафик после его настройки. При создании нового канала, если значение не задано, значение по умолчанию auto.При auto, указывает, что система автоматически определяет, какие интерфейсы могут обрабатывать новый трафик. Для варианта auto, членские каналы должны иметь одинаковый тип среды и скорость.При maximum-bandwidth, указывает, что система определяет, какие интерфейсы могут обрабатывать новый трафик на основе максимальной пропускной способности членов. | |
| name строка / обязательно | Указывает имя канала. | ||
| provider словарь добавлено в 2.5 | Объект словаря, содержащий сведения о подключении. | ||
| auth_provider строка | Настраивает поставщика аутентификации для получения маркеров аутентификации от удаленного устройства. Этот параметр действительно используется при работе с устройствами BIG-IQ. | ||
| password строка / обязательно | Пароль учетной записи пользователя для подключения к BIG-IP. Можно опустить этот параметр, установив переменную среды F5_PASSWORD.псевдонимы: pass, pwd | ||
| server строка / обязательно | Хост BIG-IP. Можно опустить этот параметр, установив переменную среды F5_SERVER. | ||
| server_port целое число | По умолчанию: 443 | Порт сервера BIG-IP. Можно опустить этот параметр, установив переменную среды F5_SERVER_PORT. | |
| ssh_keyfile путь | Указывает SSH-ключевой файл для аутентификации подключения к удаленному устройству. Этот аргумент используется только для транспортов cli. Можно опустить этот параметр, установив переменную среды ANSIBLE_NET_SSH_KEYFILE. | ||
| timeout целое число | Указывает тайм-аут в секундах для связи с сетевым устройством при подключении или отправке команд. Если тайм-аут будет превышен до завершения операции, модуль выдаст ошибку. | ||
| transport строка |
| Настраивает транспортное соединение для подключения к удаленному устройству. | |
| user строка / обязательно | Имя пользователя для подключения к BIG-IP. У этого пользователя должны быть административные привилегии на устройстве. Можно опустить этот параметр, установив переменную среды F5_USER. | ||
| validate_certs логическое |
| Если no, сертификаты SSL не будут проверены. Используйте только на контролируемых вами сайтах с самоподписанными сертификатами.Можно опустить этот параметр, установив переменную среды F5_VALIDATE_CERTS. | |
| qinq_ethertype необработанные данные добавлено в 2.7 | Указывает значение 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, сохранится на диске, необходимо включить хотя бы одну задачу, использующую модуль 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 строка | changed | Описание канала. Пример: Мой канал |
| frame_distribution_hash строка | changed | Хэш, используемый системой в качестве алгоритма распределения кадров. Пример: src-dst-ipport |
| interfaces список | changed | Интерфейсы, входящие в состав канала. Пример: ['int1', 'int2'] |
| lacp_enabled булево | changed | Поддерживает ли система протокол агрегирования каналов LACP или нет. Пример: True |
| lacp_mode строка | changed | Режим работы LACP, если опция lacp включена для канала. Пример: active |
| lacp_timeout строка | changed | Скорость, с которой система отправляет управляющие пакеты LACP. Пример: long |
| link_selection_policy строка | changed | Политика LACP, используемая каналом для определения, какой членский интерфейс может обрабатывать новые данные. Пример: auto |
| qinq_ethertype строка | changed | Значение Ether-type, используемое для пакетов, обрабатываемых этим каналом, когда он является членом VLAN QinQ. Пример: 37120 |
Статус
- Данный модуль не гарантирует обратной совместимости интерфейса. [превью]
- Этот модуль поддерживается партнером Ansible. [сертифицировано]
Авторы
- 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.9/modules/bigip_trunk_module.html
