f5networks.f5_modules.bigip_interface – Модуль для управления физическими интерфейсами BIG-IP.

Примечание

Этот плагин входит в коллекцию f5networks.f5_modules (версия 1.6.0).

Для его установки используйте: ansible-galaxy collection install f5networks.f5_modules.

Для использования в книге задач укажите: f5networks.f5_modules.bigip_interface.

Новое в версии 1.0.0: of f5networks.f5_modules

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

Описание

Модуль для управления физическими интерфейсами BIG-IP.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
bundle строка		Варианты: enabled disabled not-supported	Включает или отключает функциональность bundle. Этот параметр поддерживается только на определённых платформах и интерфейсах оборудования. Попытка включить этот параметр на `VE` или любой другой неподдерживаемой платформе/интерфейсе приведёт к ошибке выполнения модуля.
bundle_speed строка		Варианты: 100G 40G not-supported	Устанавливает скорость bundle, применимую только когда bundle `yes`. Этот параметр поддерживается только на определённых платформах и интерфейсах оборудования. Попытка включить этот параметр на `VE` или любой другой неподдерживаемой платформе/интерфейсе приведёт к ошибке выполнения модуля.
description строка			Пользовательское описание.
enabled логический тип		Варианты: no yes	Указывает текущий статус интерфейса. При `yes`, разрешает интерфейсу передавать трафик. При `no`, запрещает интерфейсу передавать трафик.
flow_control строка		Варианты: none rx tx tx-rx	Указывает, как система управляет отправкой фреймов PAUSE. При `tx-rx`, интерфейс учитывает паузы, отправляемые его партнёром, и генерирует паузы при необходимости. При `tx`, интерфейс игнорирует паузы от партнёра, и генерирует паузы при необходимости. При `rx`, интерфейс учитывает паузы от партнёра, но не генерирует паузы. При (none), управление потоком отключено на интерфейсе.
force_gigabit_fiber логический тип		Варианты: no yes	Включает или отключает принудительное использование медиа gigabit fiber. При `yes`, для интерфейса gigabit fiber, настройки медиа будут принудительно установлены, и не будет выполняться автоматическое согласование. При `no`, выполняется автоматическое согласование только с одним вариантом gigabit fiber.
forward_error_correction строка		Варианты: enabled disabled not-supported auto	Включает или отключает IEEE 802.3bm Clause 91 Reed-Solomon Forward Error Correction на интерфейсах 100G. Недействительно для медиа LR4. Этот параметр поддерживается только на определённых платформах и интерфейсах оборудования. Попытка включить этот параметр на `VE` или любой другой неподдерживаемой платформе/интерфейсе приведёт к ошибке выполнения модуля.
lldp_admin строка		Варианты: disable rxonly txonly txrx	Указывает настройки LLDP на уровне интерфейса. При `disabled`, интерфейс не отправляет и не получает сообщения LLDP ни от, ни к соседним устройствам. При `txonly`, интерфейс отправляет сообщения LLDP соседним устройствам, но не получает их. При `rxonly`, интерфейс получает сообщения LLDP от соседних устройств, но не отправляет их. При `txrx`, интерфейс отправляет и получает сообщения LLDP с соседними устройствами.
lldp_tlvmap целое число			Указывает содержимое сообщения LLDP, отправляемого или получаемого. Каждый атрибут LLDP, указанный этим параметром, является необязательным и представлен в формате Тип, Длина, Значение (TLV). Три обязательных TLV, не учитываемых при вычислении этого значения: `Chassis ID`, `Port ID`, и `TTL`. Доступные необязательные атрибуты имеют определённое числовое значение TLV, сопоставленное им. Атрибут `Port Description` имеет значение TLV `8`. Атрибут `System Name` имеет значение TLV `16`. Атрибут `System Description` имеет значение TLV `32`. Атрибут `System Capabilities` имеет значение TLV `64`. Атрибут `Management Address` имеет значение TLV `128`. Атрибут `Port VLAN ID` имеет значение TLV `256`. Атрибут `VLAN Name` имеет значение TLV `512`. Атрибут `Port and Protocol VLAN ID` имеет значение TLV `1024`. Атрибут `Protocol Identity` имеет значение TLV `2048`. Атрибут `MAC/PHY Config Status` имеет значение TLV `4096`. Атрибут `Link Aggregation` имеет значение TLV `8192`. Атрибут `Max Frame Size` имеет значение TLV `32768`. Атрибут `Product Model` имеет значение TLV `65536`. `lldp_tlvmap` - числовое значение, являющееся суммой всех значений TLV выбранных атрибутов. Установив `lldp_tlvmap` в `0` удаляет все атрибуты с интерфейса. Установив `lldp_tlvmap` в `114680` добавляет все атрибуты на интерфейс.
media_fixed строка		Варианты: 100000-FD 100000LR4-FD 10000LR-FD 10000T-FD 1000SX-FD 100TX-FD 10T-HD 20000-FD 40000LR4-FD 100000AR4-FD 100000SR4-FD 10000SFPCU-FD 1000CX-FD 1000T-FD 100TX-HD 12000-FD 21000-FD 40000SR4-FD 100000CR4-FD 10000ER-FD 10000SR-FD 1000LX-FD 1000T-HD 10T-FD 16000-FD 40000-FD 42000-FD auto no-phy	Указывает настройки для фиксированного (неподключаемого) интерфейса. Используйте этот параметр только с комбинированным портом, чтобы указать тип медиа для фиксированного интерфейса, если это не предпочтительный порт.
media_sfp строка		Варианты: 100000-FD 100000LR4-FD 10000LR-FD 10000T-FD 1000SX-FD 100TX-FD 10T-HD 20000-FD 40000LR4-FD 100000AR4-FD 100000SR4-FD 10000SFPCU-FD 1000CX-FD 1000T-FD 100TX-HD 12000-FD 21000-FD 40000SR4-FD 100000CR4-FD 10000ER-FD 10000SR-FD 1000LX-FD 1000T-HD 10T-FD 16000-FD 40000-FD 42000-FD auto no-phy	Указывает настройки для SFP (подключаемого) интерфейса. Используйте этот параметр только с комбинированным портом, чтобы указать тип медиа для SFP интерфейса, если это не предпочтительный порт.
name строка / обязательно			Указывает имя интерфейса для управления.
port_fwd_mode строка		Варианты: l3 passive virtual-wire	Указывает режим работы.
prefer_port строка		Варианты: sfp fixed	Указывает, какой стороной комбинированного порта использует интерфейс, если обе стороны имеют возможность внешнего подключения. Значение по умолчанию для комбинированного порта - sfp. Не используйте этот параметр для некомбинированных портов.
provider словарь добавлен в 1.0.0 f5networks.f5_modules			Объект словаря, содержащий данные подключения.
	auth_provider строка		Настраивает поставщика аутентификации для получения маркеров аутентификации от удалённого устройства. Этот параметр действительно используется при работе с устройствами BIG-IQ.
	no_f5_teem логический тип	Варианты: no yes	Если `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 строка	Варианты: rest ←	Настраивает транспортное соединение, используемое при подключении к удалённому устройству.

	пользователь строка / обязательно		Имя пользователя для подключения к BIG-IP. У этого пользователя должны быть административные привилегии на устройстве. Этот параметр можно опустить, установив переменную среды `F5_USER`.
	validate_certs логическое	Варианты: нет да ←	Если `no`, сертификаты SSL не будут проверены. Используйте только на контролируемых вами сайтах с самозаверенными сертификатами. Этот параметр можно опустить, установив переменную среды `F5_VALIDATE_CERTS`.
sflow словарь			Устанавливает параметры sFlow для интерфейса.
	poll_interval целое число		Указывает максимальный интервал между двумя опросами в секундах. Для того, чтобы это значение вступило в силу, `poll_interval_global` должно быть установлено в `no`. Допустимый диапазон значений: 0 - 4294967295.
	poll_interval_global логическое	Варианты: нет да	Указывает, будет ли глобальное значение интерфейса `poll_interval` переопределять значение на уровне объекта `poll_interval`. При `yes` значение `poll_interval` не применится.
stp логическое		Варианты: нет да	Включает или отключает STP.
stp_auto_edge_port логическое		Варианты: нет да	Устанавливает автоматическое определение интерфейса края STP для интерфейса. Когда `yes`, система отслеживает интерфейс на наличие входящих пакетов STP, RSTP или MSTP. Если такие пакеты не принимаются в течение достаточного периода времени (примерно три секунды), интерфейсу автоматически назначается статус порта края. Когда `no`, система никогда не устанавливает автоматически статус интерфейса как порт края. Любое значение STP, установленное на уровне интерфейса, применяется ко всем экземплярам дерева развёртывания.
stp_edge_port логическое		Варианты: нет да	Указывает, подключен ли интерфейс к конечной точке вместо другого моста дерева развёртывания.
stp_link_type строка		Варианты: авто p2p общий	Указывает тип связи STP для интерфейса.

Примечания

Примечание

Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на сайте https://www.ansible.com/integrations/networks/f5.
Требуется версия ПО BIG-IP >= 12.
Модули F5 изменяют только рабочую конфигурацию продукта F5. Чтобы убедиться, что специфичная для BIG-IP конфигурация сохранится на диске, обязательно включите хотя бы одну задачу, использующую модуль f5networks.f5_modules.bigip_config для сохранения рабочей конфигурации. Обратитесь к документации модуля для правильного использования модуля для сохранения рабочей конфигурации.

Примеры

- name: Update Interface Settings
  bigip_interface:
    name: 1.1
    stp: yes
    stp_auto_edge_port: no
    stp_edge_port: yes
    stp_link_type: shared
    description: my description
    flow_control: tx
    lldp_admin: txrx
    lldp_tlvmap: 8
    force_gigabit_fiber: no
    sflow:
      - poll_interval: 10
      - poll_interval_global: no
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

- name: Disable Interface
  bigip_interface:
    name: 1.1
    enabled: no
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

- name: Change sflow interface settings
  bigip_interface:
    name: 1.1
    sflow:
      - poll_interval: 0
      - poll_interval_global: yes
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

Значения возврата

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

Ключ		Возвращаемое значение	Описание
bundle строка		изменено	Включает или отключает возможность объединения. Пример: не поддерживается
bundle_speed строка		изменено	Скорость объединения. Пример: 100Гбит/с
description строка		изменено	Пользовательское описание. Пример: мое описание
enabled логическое		изменено	Текущий статус интерфейса. Пример: True
flow_control строка		изменено	Указывает, как система управляет отправкой фреймов PAUSE. Пример: tx
force_gigabit_fiber логическое		изменено	Включает или отключает принудительное использование медиа gigabit fiber. Пример: True
forward_error_correction строка		изменено	Включает или отключает исправление ошибок. Пример: авто
lldp_admin строка		изменено	Параметры LLDP на уровне интерфейса. Пример: txrx
lldp_tlvmap целое число		изменено	Содержание сообщения LLDP, отправляемого или получаемого. Пример: 136
media_fixed строка		изменено	Настройки фиксированного интерфейса. Пример: 100000-FD
media_sfp строка		изменено	Настройки интерфейса SFP. Пример: 100000-FD
port_fwd_mode строка		изменено	Режим работы. Пример: пассивный
prefer_port строка		изменено	Сторона комбинированного порта, используемого интерфейсом. Пример: фиксированный
sflow сложный		изменено	Устанавливает параметры sFlow для интерфейса. Пример: хеш/словарь значений
	poll_interval целое число	изменено	Максимальный интервал в секундах между двумя опросами. Пример: 128
	poll_interval_global логическое	изменено	Глобальные настройки sFlow переопределяют. Пример: True
stp логическое		изменено	Включает или отключает STP.
stp_auto_edge_port логическое		изменено	Устанавливает автоматическое определение интерфейса края STP для интерфейса. Пример: True
stp_edge_port логическое		изменено	Указывает, подключен ли интерфейс к конечной точке вместо другого моста дерева развёртывания.
stp_link_type строка		изменено	Тип связи STP для интерфейса. Пример: общий

Авторы

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.10/collections/f5networks/f5_modules/bigip_interface_module.html