Spec-Zone.ru › Ansible

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

Примечание

Этот модуль является частью коллекции f5networks.f5_modules (версия 1.31.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить её установку, выполните ansible-galaxy collection list.

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

Чтобы использовать её в плейбуке, укажите: f5networks.f5_modules.bigip_interface.

Впервые в f5networks.f5_modules 1.0.0

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

Обзор

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

Параметры

Параметр

Комментарии

bundle

string

Включает или отключает возможность объединения.

Эта опция поддерживается только на отдельных аппаратных платформах и интерфейсах.

Попытка включить эту опцию на VE или любой другой неподдерживаемой платформе/интерфейсе приведет к сбою выполнения модуля.

Варианты:

  • "enabled"
  • "disabled"
  • "not-supported"

bundle_speed

string

Устанавливает скорость объединения, которая применима только тогда, когда объединение true.

Эта опция поддерживается только на отдельных аппаратных платформах и интерфейсах.

Попытка включить эту опцию на VE или любой другой неподдерживаемой платформе/интерфейсе приведет к сбою выполнения модуля.

Варианты:

  • "100G"
  • "40G"
  • "not-supported"

description

string

Описание, заданное пользователем.

enabled

boolean

Указывает текущий статус интерфейса.

Когда true, включает интерфейс для пропуска трафика.

Когда false, отключает интерфейс от пропуска трафика.

Варианты:

  • false
  • true

flow_control

string

Указывает, как система управляет отправкой кадров PAUSE.

Когда tx-rx, интерфейс учитывает кадры pause от своего партнера, а также генерирует кадры pause при необходимости.

Когда tx, интерфейс игнорирует кадры pause от своего партнера и генерирует кадры pause при необходимости.

Когда rx, интерфейс учитывает кадры pause от своего партнера, но не генерирует кадры pause.

Когда (none), контроль потока отключен на интерфейсе.

Варианты:

  • "none"
  • "rx"
  • "tx"
  • "tx-rx"

force_gigabit_fiber

boolean

Включает или отключает принудительное использование гигабитного волоконно-оптического носителя.

Когда true для гигабитного волоконно-оптического интерфейса, настройка носителя будет принудительно установлена, и автоопределение выполняться не будет.

Когда false будет выполнено автоопределение с объявлением только одного гигабитного волоконно-оптического варианта.

Варианты:

  • false
  • true

forward_error_correction

string

Включает или отключает коррекцию ошибок в прямом направлении IEEE 802.3bm Clause 91 Reed-Solomon на 100G интерфейсах. Недействительно для носителя LR4.

Эта опция поддерживается только на отдельных аппаратных платформах и интерфейсах.

Попытка включить эту опцию на VE или любой другой неподдерживаемой платформе/интерфейсе приведет к сбою выполнения модуля.

Варианты:

  • "enabled"
  • "disabled"
  • "not-supported"
  • "auto"

lldp_admin

string

Указывает параметры LLDP на уровне интерфейса.

Когда disabled, интерфейс не передает (отправляет) сообщения LLDP и не получает сообщения LLDP от соседних устройств.

Когда txonly, интерфейс передает сообщения LLDP соседним устройствам, но не получает сообщения LLDP от соседних устройств.

Когда rxonly, интерфейс получает сообщения LLDP от соседних устройств, но не передает сообщения LLDP соседним устройствам.

Когда txrx, интерфейс передает сообщения LLDP и получает сообщения LLDP от соседних устройств.

Варианты:

  • "disable"
  • "rxonly"
  • "txonly"
  • "txrx"

lldp_tlvmap

integer

Указывает содержимое отправляемого или получаемого сообщения 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

string

Указывает параметры для фиксированного (не-подключаемого) интерфейса.

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

Варианты:

  • "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

string

Указывает настройки интерфейса SFP (вставляемого).

Используйте этот параметр только с комбинированным портом для указания типа среды для интерфейса 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"

name

string / обязательно

Указывает имя интерфейса для управления.

port_fwd_mode

string

Указывает режим работы.

Варианты:

  • "l3"
  • "passive"
  • "virtual-wire"

prefer_port

string

Указывает, какую сторону комбинированного порта использует интерфейс, если обе стороны могут иметь внешний канал.

Значение по умолчанию для комбинированного порта — sfp. Не используйте этот параметр для портов, которые не являются комбинированными.

Варианты:

  • "sfp"
  • "fixed"

provider

словарь

добавлен в f5networks.f5_modules 1.0.0

Объект словаря, содержащий данные соединения.

auth_provider

строка

Настраивает поставщика аутентификации для получения маркеров аутентификации с удаленного устройства.

Этот параметр фактически используется при работе с устройствами BIG-IQ.

no_f5_teem

булево

Если yes, данные телеметрии TEEM не отправляются в F5.

Вы можете опустить этот параметр, установив переменную среды F5_TELEMETRY_OFF.

Предыдущая переменная F5_TEEM устарела, так как ее имя было неясным.

Варианты:

  • false ← (значение по умолчанию)
  • true

password

псевдонимы: pass, pwd

строка / обязательно

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

Вы можете опустить этот параметр, установив переменную среды F5_PASSWORD.

server

строка / обязательно

Хост BIG-IP или хост BIG-IQ.

Вы можете опустить этот параметр, установив переменную среды F5_SERVER.

server_port

целое число

Порт сервера BIG-IP.

Вы можете опустить этот параметр, установив переменную среды F5_SERVER_PORT.

Значение по умолчанию: 443

timeout

целое число

Указывает таймаут в секундах для связи с сетевым устройством для подключения или отправки команд. Если таймаут истечёт до завершения операции, модуль выдаст ошибку.

transport

строка

Настраивает транспортное соединение для использования при подключении к удаленному устройству.

Варианты:

  • "rest" ← (значение по умолчанию)

user

строка / обязательно

Имя пользователя для подключения к BIG-IP или BIG-IQ. Этот пользователь должен иметь права администратора на устройстве.

Вы можете опустить этот параметр, установив переменную среды F5_USER.

validate_certs

булево

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

Вы можете опустить этот параметр, установив переменную среды F5_VALIDATE_CERTS.

Варианты:

  • false
  • true ← (значение по умолчанию)

sflow

словарь

Указывает настройки sFlow для интерфейса.

poll_interval

целое число

Указывает максимальный интервал между двумя опросами в секундах.

Для того, чтобы это значение вступило в силу, poll_interval_global должно быть установлено в false.

Допустимый диапазон — 0–4294967295.

poll_interval_global

boolean

Указывает, переопределяет ли глобальная настройка интерфейса poll_interval значение на уровне объекта poll_interval.

Когда true) значение poll_interval не применяется.

Варианты:

  • false
  • true

stp

boolean

Включает или отключает STP.

Варианты:

  • false
  • true

stp_auto_edge_port

boolean

Устанавливает автоматическое обнаружение порта граничного устройства STP для интерфейса.

Когда true, система отслеживает интерфейс на предмет входящих пакетов STP, RSTP или MSTP. Если такие пакеты не принимаются в течение достаточного времени (примерно три секунды), интерфейсу автоматически присваивается статус порта граничного устройства.

Когда false, система никогда не присваивает интерфейсу автоматически статус порта граничного устройства. Любая настройка STP, установленная на уровне интерфейса, применяется ко всем экземплярам spanning tree.

Варианты:

  • false
  • true

stp_edge_port

boolean

Указывает, подключен ли интерфейс к конечному устройству, а не к другому мосту spanning tree.

Варианты:

  • false
  • true

stp_link_type

string

Указывает тип соединения STP для интерфейса.

Варианты:

  • "auto"
  • "p2p"
  • "shared"

Примечания

Примечание

  • Дополнительную информацию об использовании 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: true
    stp_auto_edge_port: false
    stp_edge_port: true
    stp_link_type: shared
    description: my description
    flow_control: tx
    lldp_admin: txrx
    lldp_tlvmap: 8
    force_gigabit_fiber: false
    sflow:
      - poll_interval: 10
      - poll_interval_global: false
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

- name: Disable Interface
  bigip_interface:
    name: 1.1
    enabled: false
    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: true
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

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

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

Ключ

Описание

bundle

string

Включает или отключает возможность объединения.

Возвращено: changed

Пример: "not-supported"

bundle_speed

string

Скорость объединения.

Возвращено: changed

Пример: "100G"

description

string

Описание, заданное пользователем.

Возвращено: changed

Пример: "my description"

enabled

boolean

Текущий статус интерфейса.

Возвращено: changed

Пример: true

flow_control

string

Указывает, как система управляет отправкой кадров PAUSE.

Возвращено: changed

Пример: "tx"

force_gigabit_fiber

boolean

Включает или отключает принудительное использование гигабитного оптоволоконного носителя.

Возвращено: changed

Пример: true

forward_error_correction

string

Включает или отключает коррекцию ошибок при передаче.

Возвращено: changed

Пример: "auto"

lldp_admin

string

Параметры LLDP на уровне интерфейса.

Возвращено: changed

Пример: "txrx"

lldp_tlvmap

integer

Содержимое сообщения LLDP, отправляемого или принимаемого.

Возвращено: changed

Пример: 136

media_fixed

string

Параметры для фиксированного интерфейса.

Возвращено: changed

Пример: "100000-FD"

media_sfp

string

Параметры для SFP-интерфейса.

Возвращено: changed

Пример: "100000-FD"

port_fwd_mode

string

Режим работы.

Возвращено: changed

Пример: "passive"

prefer_port

string

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

Возвращено: changed

Пример: "fixed"

sflow

complex

Указывает параметры sFlow для интерфейса.

Возвращено: changed

Пример: "hash/dictionary of values"

poll_interval

integer

Максимальный интервал в секундах между двумя опросами.

Возвращено: changed

Пример: 128

poll_interval_global

boolean

Переопределение глобальных параметров sFlow.

Возвращено: changed

Пример: true

stp

boolean

Включает или отключает STP.

Возвращено: changed

Пример: false

stp_auto_edge_port

boolean

Устанавливает автоматическое обнаружение портов края STP для интерфейса.

Возвращено: changed

Пример: true

stp_edge_port

boolean

Указывает, подключён ли интерфейс к конечной станции вместо другого моста spanning tree.

Возвращено: changed

Пример: false

stp_link_type

string

Тип связи STP для интерфейса.

Возвращено: changed

Пример: "shared"

Авторы

  • Wojciech Wypior (@wojtek0806)

Ссылки на сборку

  • Система отслеживания ошибок
  • Главная страница
  • Репозиторий (исходные коды)

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/f5networks/f5_modules/bigip_interface_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API