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

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

Описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

Описание

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

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

f5-sdk >= 3.0.16

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
описание - добавлено в 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 boolean		Варианты: 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		Значение по умолчанию: null	Объект словаря, содержащий данные подключения.
	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 - / обязательно	Варианты: rest cli ←	Настраивает транспортное соединение для подключения к удалённому устройству.
	user - / обязательно		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Этот параметр можно опустить, установив переменную окружения `F5_USER`.
	validate_certs boolean	Варианты: 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

добавлено в 2.0

Варианты:

нет
да ←

Если no, сертификаты SSL не проверяются. Используйте только на сайтах под вашим контролем, использующих самоподписанные сертификаты.

Этот параметр можно опустить, установив переменную окружения F5_VALIDATE_CERTS.

Примечания

Примечание

Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
Требуется пакет f5-sdk Python на хосте. Это так же просто, как pip install f5-sdk.
Требуется версия ПО 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 строка	изменилось	Описание ствола. Пример: Мой ствол
frame_distribution_hash строка	изменилось	Хэш, который система использует в качестве алгоритма распределения кадров. Пример: src-dst-ipport
interfaces список	изменилось	Интерфейсы, которые являются частью ствола. Пример: ['int1', 'int2']
lacp_enabled boolean	изменилось	Поддерживает ли система протокол управления агрегацией каналов (LACP) или нет. Пример: True
lacp_mode строка	изменилось	Режим работы LACP, если для ствола включён параметр lacp. Пример: активно
lacp_timeout строка	изменилось	Скорость, с которой система отправляет управляющие пакеты LACP. Пример: длинный
link_selection_policy строка	изменилось	Политика LACP, которую использует ствол, чтобы определить, какой член канала (интерфейс) может обрабатывать новый трафик. Пример: автоматический
qinq_ethertype строка	изменилось	Значение ether-type, используемое для пакетов, обрабатываемых этим стволом, когда он является членом VLAN QinQ. Пример: 37120

Статус

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

Авторы

Tim Rupp (@caphrim007)

Подсказка

Если вы заметите какие-либо проблемы в данной документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/bigip_trunk_module.html