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

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

Описание
- Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус
Техническое обслуживание
- Автор

Описание

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

Требования

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

f5-sdk >= 3.0.9

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
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 bool		Варианты: 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` установлена.
	user обязательно		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Этот параметр можно опустить, если переменная среды `F5_USER` установлена.
	validate_certs bool	Варианты: no yes ←	Если `no`, сертификаты SSL не будут проверены. Используйте только на сайтах, контролируемых лично, с самозаверенными сертификатами. Этот параметр можно опустить, если переменная среды `F5_VALIDATE_CERTS` установлена.
	timeout	По умолчанию: 10	Указывает таймаут в секундах для связи с сетевым устройством при подключении или отправке команд. Если таймаут истечет до завершения операции, модуль выдаст ошибку.
	ssh_keyfile		Указывает SSH-ключевой файл для аутентификации подключения к удалённому устройству. Этот аргумент используется только для транспортов cli. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_SSH_KEYFILE`.
	transport обязательно	Варианты: rest cli ←	Настраивает транспортное соединение для подключения к удалённому устройству.
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 bool (добавлено в 2.0)		Варианты: no yes ←	Если `no`, сертификаты SSL не будут проверены. Используйте только на сайтах, контролируемых лично, с самозаверенными сертификатами. Этот параметр можно опустить, если переменная среды `F5_VALIDATE_CERTS` установлена.

Примечания

Примечание

Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на сайте https://www.ansible.com/integrations/networks/f5.
Требуется пакет f5-sdk Python на хосте. Это так же просто, как pip install f5-sdk.

Примеры

- name: Create a ...
  bigip_trunk:
    name: foo
    password: secret
    server: lb.mydomain.com
    state: present
    user: admin
  delegate_to: localhost

Возвращаемые значения

Общие значения возврата описаны в здесь, следующие поля уникальны для этого модуля:

Ключ	Возвращаемое значение	Описание
param1 bool	изменённое	Новое значение параметра param1 ресурса. Пример: True
param2 string	изменённое	Новое значение параметра param2 ресурса. Пример: Foo is bar

Статус

Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратной совместимости.

Техническое обслуживание

Этот модуль помечен как сообщество, что означает, что его поддерживает сообщество Ansible. Подробнее см. Техническое обслуживание и поддержка модулей.

Список других модулей, также поддерживаемых сообществом 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.6/modules/bigip_trunk_module.html