модуль dellemc.enterprise_sonic.sonic_lldp_interfaces — управление конфигурациями LLDP интерфейсов на SONiC

Примечание

Этот модуль входит в коллекцию dellemc.enterprise_sonic (версия 3.2.0).

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

Чтобы установить её, используйте: ansible-galaxy collection install dellemc.enterprise_sonic.

Чтобы использовать её в плейбуке, укажите: dellemc.enterprise_sonic.sonic_lldp_interfaces.

Добавлено в dellemc.enterprise_sonic 2.1.0

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

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

Этот модуль предназначен для управления конфигурацией параметров LLDP интерфейсов на устройствах под управлением SONiC.
Он предназначен для использования совместно с глобальной конфигурацией LLDP.

Параметры

Параметр	Описание
config list / elements=dictionary	Набор параметров атрибутов интерфейса протокола обнаружения канального уровня
enable boolean	Этот аргумент принимает логическое значение, указывающее, включить или отключить LLDP. Эта команда поддерживается только на физических, но не на логических интерфейсах. Варианты: `false` `true`
med_tlv_select dictionary	Эта команда позволяет выбрать, следует ли передавать TLV LLDP-MED. По умолчанию TLV LLDP-MED передаются. Эта команда поддерживается только на физических, но не на логических интерфейсах.
network_policy boolean	Эта команда позволяет выбрать, следует ли передавать TLV LLDP-MED с сетевой политикой. По умолчанию TLV LLDP-MED с сетевой политикой передаются. Варианты: `false` `true`
power_management boolean	Эта команда позволяет выбрать, следует ли передавать TLV LLDP-MED для управления питанием. По умолчанию TLV LLDP-MED для управления питанием передаются. Варианты: `false` `true`
mode string	По умолчанию передача и приём кадров LLDP включены. Эта команда позволяет настроить только приём или только передачу. Эта команда поддерживается на физических и логических интерфейсах. Варианты: `"receive"` `"transmit"`
name string / обязательный	Имя интерфейса, для которого необходимо настроить LLDP.
network_policy integer добавлено в dellemc.enterprise_sonic 3.1.0	Номер сетевой политики, диапазон 1–128.
tlv_select dictionary	Эта команда позволяет выбрать, следует ли передавать TLV LLDP управления питанием 802.3at или 802.3bt. По умолчанию этот TLV передаётся. Эта команда поддерживается только на физических, но не на логических интерфейсах.
link_aggregation boolean добавлено в dellemc.enterprise_sonic 3.1.0	Эта команда позволяет выбрать, следует ли передавать TLV LLDP для агрегирования каналов. По умолчанию TLV LLDP для агрегирования каналов передаются. Варианты: `false` `true`
max_frame_size boolean добавлено в dellemc.enterprise_sonic 3.1.0	Эта команда позволяет выбрать, следует ли передавать TLV LLDP с максимальным размером кадра. По умолчанию TLV LLDP с максимальным размером кадра передаются. Варианты: `false` `true`
port_vlan_id boolean добавлено в dellemc.enterprise_sonic 3.1.0	Эта команда позволяет выбрать, следует ли передавать TLV LLDP с идентификатором VLAN порта. По умолчанию TLV LLDP с идентификатором VLAN порта передаются. Варианты: `false` `true`
power_management boolean	Эта команда позволяет выбрать, следует ли передавать TLV LLDP для управления питанием. По умолчанию TLV LLDP для управления питанием передаются. Варианты: `false` `true`
vlan_name boolean добавлено в dellemc.enterprise_sonic 3.1.0	Эта команда позволяет выбрать, следует ли передавать TLV LLDP с именем VLAN. По умолчанию TLV LLDP с именем VLAN передаются. Варианты: `false` `true`
tlv_set dictionary	Эта команда позволяет настроить IPv4- или IPv6-адрес управления, который LLDP будет передавать на интерфейсе. Эта команда поддерживается только на физических, но не на логических интерфейсах.
ipv4_management_address string	Настройка IPv4-адреса управления для LLDP в формате A.B.C.D
ipv6_management_address string	Настройка IPv6-адреса управления для LLDP в формате A:B::C:D
vlan_name_tlv dictionary добавлено в dellemc.enterprise_sonic 3.1.0	Эта команда позволяет настроить список VLAN для передачи TLV с именами VLAN. Эта команда поддерживается только на физических, но не на логических интерфейсах.
allowed_vlans list / elements=dictionary	Эта команда позволяет настроить список VLAN для передачи TLV с именами VLAN. Можно настроить несколько VLAN или диапазонов VLAN. Диапазоны задаются начальным и конечным значениями VLAN, разделёнными дефисом. Настраиваемые VLAN должны находиться в диапазоне 1–4094.
vlan string	Настраивает указанную VLAN или диапазон VLAN.
max_tlv_count integer	Эта команда позволяет настроить максимальное количество TLV с именами VLAN, передаваемых на интерфейсе. Диапазон — 1–128, значение по умолчанию — 10.
state string	Параметр состояния задаёт тип обновления конфигурации, которое будет выполнено на устройстве. Для состояния «merged» указанные атрибуты объединяются с уже настроенными атрибутами. Для состояния «deleted» указанные атрибуты удаляются из существующей конфигурации. Для состояния «replaced» конфигурация LLDP интерфейсов указанных интерфейсов заменяется предоставленной конфигурацией. Для состояния «overridden» все конфигурации LLDP интерфейсов на устройстве заменяются предоставленной конфигурацией. Варианты: `"merged"` ← (по умолчанию) `"deleted"` `"replaced"` `"overridden"`

Примечания

Примечание

Протестировано на Enterprise SONiC Distribution от Dell Technologies.
Поддерживается check_mode.

Примеры

# Using "deleted" state
#
# Before state:
# -------------
# sonic# show running-configuration interface Ethernet 1
# !
# interface Ethernet1
#  mtu 9100
#  speed 25000
#  unreliable-los auto
#  no shutdown
#  lldp transmit
#  network-policy 1
#  lldp tlv-set management-address ipv4 10.1.1.2
# sonic#

- name: Delete LLDP interface configurations
  dellemc.enterprise_sonic.sonic_lldp_interfaces:
    config:
      - name: Ethernet1
        mode: transmit
        network_policy: 1
        tlv_set:
          ipv4_management_address: 10.1.1.2
    state: deleted

# After state:
# ------------
# sonic# show running-configuration interface Ethernet 1
# !
# interface Ethernet1
#  mtu 9100
#  speed 25000
#  unreliable-los auto
#  no shutdown
# sonic#


# Using "deleted" state
#
# Before state:
# -------------
# sonic# show running-configuration interface
# !
# interface Ethernet0
#  mtu 9100
#  speed 25000
#  unreliable-los auto
#  no shutdown
# !
# interface Ethernet1
#  mtu 9100
#  speed 25000
#  unreliable-los auto
#  no shutdown
# !
# sonic#

- name: Delete default LLDP Interface configurations
  dellemc.enterprise_sonic.sonic_lldp_interfaces:
    config:
      - name: Ethernet1
        tlv_select:
          power-management: true
          port_vlan_id: true
          vlan_name: true
          link_aggregation: true
          max_frame_size: true
        med_tlv_select:
          network_policy: true
    state: deleted

# After State:
# ------------
# sonic# show running-configuration interface
# !
# interface Ethernet0
#  mtu 9100
#  speed 25000
#  unreliable-los auto
#  no shutdown
# !
# interface Ethernet1
#  mtu 9100
#  speed 25000
#  unreliable-los auto
#  no shutdown
#  no lldp med-tlv-select network-policy
#  no lldp tlv-select power-management
#  no lldp tlv-select port-vlan-id
#  no lldp tlv-select vlan-name
#  no lldp tlv-select link-aggregation
#  no lldp tlv-select max-frame-size
# sonic#


# Using "deleted" state
#
# Before state:
# -------------
# sonic# show running-configuration interface
# !
# interface Ethernet0
#  mtu 9100
#  speed 25000
#  unreliable-los auto
#  no shutdown
#  lldp receive
#  lldp tlv-set management-address ipv4 20.1.1.1
#  lldp vlan-name-tlv allowed Vlan 10,15-20
#  lldp vlan-name-tlv max-tlv-count 15
# !
# interface Ethernet1
#  mtu 9100
#  speed 25000
#  unreliable-los auto
#  no shutdown
#  lldp transmit
#  lldp tlv-set management-address ipv4 21.1.1.1
#  lldp vlan-name-tlv allowed Vlan 10,15-20
#  lldp vlan-name-tlv max-tlv-count 15
# !
# sonic#

- name: Delete default LLDP Interface configurations
  dellemc.enterprise_sonic.sonic_lldp_interfaces:
    config:
      - name: Ethernet0
        vlan_name_tlv:
          allowed_vlans:
            - vlan: 10
            - vlan: 15-20
          max_tlv_count: 15
      - name: Ethernet1
    state: deleted

# After state:
# ------------
# sonic# show running-configuration interface
# !
# interface Ethernet0
#  mtu 9100
#  speed 25000
#  unreliable-los auto
#  no shutdown
#  lldp receive
#  lldp tlv-set management-address ipv4 20.1.1.1
# !
# interface Ethernet1
#  mtu 9100
#  speed 25000
#  unreliable-los auto
#  no shutdown
# sonic#


# Using "merged" state
#
# Before state:
# -------------
# sonic# show running-configuration interface
# !
# interface Ethernet0
#  mtu 9100
#  speed 25000
#  unreliable-los auto
#  no shutdown
# !
# interface Ethernet1
#  mtu 9100
#  speed 25000
#  unreliable-los auto
#  no shutdown
#  no lldp enable
# !
# sonic#

- name: Modify LLDP Interface configurations
  dellemc.enterprise_sonic.sonic_lldp_interfaces:
    config:
      - name: Ethernet1
        enable: true
        mode: transmit
        network_policy: 2
        med_tlv_select:
          power_management: true
        tlv_set:
          ipv4_management_address: 10.1.1.2
        vlan_name_tlv:
          allowed_vlans:
            - vlan: 10
            - vlan: 15-20
          max_tlv_count: 15
    state: merged

# After State:
# ------------
# sonic# show running-configuration interface
# !
# interface Ethernet0
#  mtu 9100
#  speed 25000
#  unreliable-los auto
#  no shutdown
# !
# interface Ethernet1
#  mtu 9100
#  speed 25000
#  unreliable-los auto
#  no shutdown
#  lldp transmit
#  network-policy 2
#  lldp tlv-set management-address ipv4 10.1.1.2
#  lldp vlan-name-tlv allowed Vlan 10,15-20
#  lldp vlan-name-tlv max-tlv-count 15
# sonic#

# Using "replaced" state
#
# Before state:
# -------------
#
# sonic# show running-configuration interface
# !
# interface Eth1/5
#  mtu 9100
#  speed 10000
#  unreliable-los auto
#  no shutdown
#  lldp tlv-set management-address ipv6 10::1
#  no lldp med-tlv-select network-policy
#  no lldp med-tlv-select power-management
#  lldp vlan-name-tlv allowed Vlan 10,15-20
#  lldp vlan-name-tlv max-tlv-count 15
#
# !
# interface Eth1/6
#  mtu 9100
#  speed 10000
#  unreliable-los auto
#  no shutdown
#  no lldp med-tlv-select power-management
#  no lldp tlv-select power-management

- name: Replace LLDP interface configurations
  dellemc.enterprise_sonic.sonic_lldp_interfaces:
    config:
      - name: Eth1/5
        mode: receive
        tlv_set:
          ipv6_management_address: '30::1'
        med_tlv_select:
          network_policy: false
        vlan_name_tlv:
          allowed_vlans:
            - vlan: 20-30
          max_tlv_count: 20
    state: replaced

# After State:

# ------------
#
# sonic# show running-configuration interface
# !
# interface Eth1/5
#  mtu 9100
#  speed 10000
#  unreliable-los auto
#  no shutdown
#  lldp receive
#  lldp tlv-set management-address ipv6 30::1
#  no lldp med-tlv-select network-policy
#  lldp vlan-name-tlv allowed Vlan 20-30
#  lldp vlan-name-tlv max-tlv-count 20
# !
# interface Eth1/6
#  mtu 9100
#  speed 10000
#  unreliable-los auto
#  no shutdown
#  no lldp med-tlv-select power-management
#  no lldp tlv-select power-management

# Using "overridden" state
#
# Before state:
# -------------
#
# sonic# show running-configuration interface
# interface Eth1/5
#  mtu 9100
#  speed 10000
#  unreliable-los auto
#  no shutdown
#  lldp transmit
#  lldp tlv-set management-address ipv6 30::2
# !
# interface Eth1/6
#  mtu 9100
#  speed 10000
#  unreliable-los auto
#  no shutdown
#  lldp transmit
#  lldp tlv-set management-address ipv4 40.1.1.1

- name: Override LLDP interface configurations
  dellemc.enterprise_sonic.sonic_lldp_interfaces:
    config:
      - name: Eth1/5
        mode: receive
        tlv_set:
          ipv4_management_address: '10.1.1.2'
        vlan_name_tlv:
          allowed_vlans:
            - vlan: 10
            - vlan: 15-20
          max_tlv_count: 15
    state: overridden

# After state:
# ------------
#
# sonic# show running-configuration interface
# !
# interface Eth1/5
#  mtu 9100
#  speed 10000
#  unreliable-los auto
#  no shutdown
#  lldp receive
#  lldp tlv-set management-address ipv4 10.1.1.2
#  lldp vlan-name-tlv allowed Vlan 10,15-20
#  lldp vlan-name-tlv max-tlv-count 15
# !
# interface Eth1/6
#  mtu 9100
#  speed 10000
#  unreliable-los auto
#  no shutdown

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

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

Ключ	Описание
after list / elements=string	Результирующая конфигурация после выполнения модуля. Возвращается: при изменении Пример: `["The configuration returned will always be in the same format as the parameters above.\n"]`
after(generated) list / elements=string	Конфигурация, сгенерированная при выполнении модуля. Возвращается: при `check_mode` Пример: `["The configuration returned will always be in the same format\n of the parameters above.\n"]`
before list / elements=string	Конфигурация до выполнения модуля. Возвращается: всегда Пример: `["The configuration returned will always be in the same format as the parameters above.\n"]`
commands list / elements=string	Набор команд, отправленных на удалённое устройство. Возвращается: всегда Пример: `["command 1", "command 2", "command 3"]`

Авторы

Divya Balasubramanian(@divya-balasubramania)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/dellemc/enterprise_sonic/sonic_lldp_interfaces_module.html