bigip_trunk – Управление каналами на BIG-IP

Новая в версии 2.6.

Краткое описание
Параметры
Примечания
Примеры
Значения возврата
Статус

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

Управляет каналами на BIG-IP.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
description строка добавлен в 2.7			Описание туннеля.
frame_distribution_hash строка		Варианты: destination-mac source-destination-ip source-destination-mac	Указывает основу для хэша, который система использует в качестве алгоритма распределения кадров. Система использует полученный хэш для определения интерфейса, который необходимо использовать для пересылки трафика. При создании нового туннеля, если этот параметр не указан, значение по умолчанию — `source-destination-ip`. Если `source-destination-mac`, указывает, что система основана на совокупности MAC-адресов источника и получателя. Если `destination-mac`, указывает, что система основана на MAC-адресе получателя. Если `source-destination-ip`, указывает, что система основана на совокупности IP-адресов источника и получателя.
interfaces список			Интерфейсы, которые являются частью туннеля. Для очистки списка интерфейсов укажите пустой список.
lacp_enabled логическое		Варианты: no yes	Если `yes`, указывает, что система поддерживает протокол управления агрегацией каналов (LACP), который отслеживает туннель, обмениваясь управляющими пакетами по связанным каналам, чтобы определить состояние каналов. Если LACP обнаруживает сбой в связанном канале, он удаляет канал из агрегации. При создании нового туннеля, если этот параметр не указан, LACP `no`. LACP по умолчанию отключен для обратной совместимости. Если это не относится к вашей сети, рекомендуется включить LACP.
lacp_mode строка		Варианты: active passive	Указывает режим работы протокола управления агрегацией каналов (LACP), если LACP включен для туннеля. При создании нового туннеля, если этот параметр не указан, значение по умолчанию — `active`. Если `active`, указывает, что система периодически отправляет управляющие пакеты, независимо от того, запросил ли партнерскую систему. Если `passive`, указывает, что система отправляет управляющие пакеты только тогда, когда партнерская система выпустила запрос.
lacp_timeout строка		Варианты: long short	Указывает частоту отправки системой управляющих пакетов LACP. При создании нового туннеля, если этот параметр не указан, значение по умолчанию — `long`. Если `long`, указывает, что система отправляет управляющий пакет LACP каждые 30 секунд. Если `short`, указывает, что система отправляет управляющий пакет LACP каждые 1 секунду.
link_selection_policy строка		Варианты: auto maximum-bandwidth	Указывает политику, используемую туннелем после его настройки, для определения того, какой связанный канал (интерфейс) может обрабатывать новый трафик. При создании нового туннеля, если значение не указано, значение по умолчанию — `auto`. Если `auto`, указывает, что система автоматически определяет, какие интерфейсы могут обрабатывать новый трафик. Для варианта `auto`, все связанные каналы должны быть одного типа среды и скорости. Если `maximum-bandwidth`, указывает, что система определяет интерфейсы, способные обрабатывать новый трафик, на основе максимальной пропускной способности участников.
name строка / обязательно			Указывает имя туннеля.
password строка / обязательно			Пароль учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_PASSWORD`. Псевдонимы: pass, pwd
provider словарь добавлен в 2.5			Объект словаря, содержащий данные подключения.
	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 целое число	Значение по умолчанию: 10	Указывает тайм-аут в секундах для связи с сетевым устройством при подключении или отправке команд. Если тайм-аут истекает до завершения операции, модуль выдаст ошибку.
	transport строка	Варианты: cli rest ←	Настраивает транспортное соединение для использования при подключении к удаленному устройству.
	user строка / обязательно		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные права на устройстве. Вы можете опустить этот параметр, установив переменную среды `F5_USER`.
	validate_certs логическое	Варианты: no yes ←	Если `no`, сертификаты SSL не проверяются. Используйте только на сайтах, контролируемых лично, с самозаверяющими сертификатами. Вы можете опустить этот параметр, установив переменную среды `F5_VALIDATE_CERTS`.
qinq_ethertype сырой добавлен в 2.7			Указывает значение ether-type, используемое для пакетов, обрабатываемых этим туннелем, когда он является участником VLAN QinQ. Ether-type может быть установлен на любое значение, содержащее допустимое 16-битное шестнадцатеричное число, или на любое известное значение ether-type; `0x8100`, `0x9100`, `0x88a8`. Этот параметр не поддерживается на виртуальных изданиях. Вы всегда должны заключать это значение в кавычки, чтобы предотвратить интерпретацию Ansible значения как буквенного шестнадцатеричного числа и преобразование в целое число.
server строка / обязательно			Хост BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_SERVER`.
server_port целое число добавлен в 2.2		Значение по умолчанию: 443	Порт сервера BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_SERVER_PORT`.
state строка		Варианты: present ← absent	Если `present`, гарантирует существование ресурса. Если `absent`, гарантирует удаление ресурса.
user строка / обязательно			Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные права на устройстве. Вы можете опустить этот параметр, установив переменную среды `F5_USER`.

validate_certs

boolean

added in 2.0

Choices:

no
yes ←

If no, SSL certificates are not validated. Use this only on personally controlled sites using self-signed certificates.

You may omit this option by setting the environment variable F5_VALIDATE_CERTS.

Примечания

Примечание

Дополнительную информацию об использовании 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 string	changed	Описание магистрали. Пример: Моя магистраль
frame_distribution_hash string	changed	Хэш, который система использует в качестве алгоритма распределения кадров. Пример: src-dst-ipport
interfaces list	changed	Интерфейсы, которые являются частью магистрали. Пример: ['int1', 'int2']
lacp_enabled boolean	changed	Поддерживает ли система протокол агрегирования каналов LACP или нет. Пример: True
lacp_mode string	changed	Режим работы LACP, если опция lacp включена для магистрали. Пример: active
lacp_timeout string	changed	Скорость, с которой система отправляет управляющие пакеты LACP. Пример: long
link_selection_policy string	changed	Политика LACP, которую магистраль использует для определения того, какой членский интерфейс (интерфейс) может обрабатывать новые трафики. Пример: auto
qinq_ethertype string	changed	Значение Ether-type, используемое для пакетов, обрабатываемых в этой магистрали, когда она является членом VLAN QinQ. Пример: 37120

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [preview]
Этот модуль поддерживается партнером Ansible. [certified]

Авторы

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.8/modules/bigip_trunk_module.html