dellemc.enterprise_sonic.sonic_lldp_interfaces 模块 – 在 SONiC 上管理接口 LLDP 配置

注意

此模块是 dellemc.enterprise_sonic 集合(版本 2.5.1)的一部分。

如果您正在使用 ansible 包,您可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装,请运行 ansible-galaxy collection list

要安装它,请使用:ansible-galaxy collection install dellemc.enterprise_sonic

要在 Playbook 中使用它,请指定:dellemc.enterprise_sonic.sonic_lldp_interfaces

dellemc.enterprise_sonic 2.1.0 中的新功能

概要

  • 此模块提供在运行 SONiC 的设备中对接口 LLDP 参数的配置管理。

  • 它旨在与全局 LLDP 结合使用。

参数

参数

注释

config

列表 / 元素=字典

链路层发现协议接口属性配置的集合

enable

布尔值

此参数是一个布尔值,用于启用或禁用 LLDP。

此命令仅在物理接口上受支持,而不在逻辑接口上受支持。

选择

  • false

  • true

med_tlv_select

字典

此命令可用于选择是否通告 LLDP-MED TLV。默认情况下,会通告 LLDP-MED TLV。

此命令仅在物理接口上受支持,而不在逻辑接口上受支持。

network_policy

布尔值

此命令可用于选择是否通告网络策略 LLDP-MED TLV。默认情况下,会通告网络策略 LLDP-MED TLV。

选择

  • false

  • true

power_management

布尔值

此命令可用于选择是否通告电源管理 LLDP-MED TLV。默认情况下,会通告电源管理 LLDP-MED TLV。

选择

  • false

  • true

mode

字符串

默认情况下,启用 LLDP 帧的发送和接收。

此命令可用于配置为仅接收或仅发送模式。

此命令在物理接口和逻辑接口上均受支持。

选择

  • "receive"

  • "transmit"

name

字符串 / 必填

需要在其上配置 LLDP 的接口名称。

tlv_select

字典

此命令可用于选择是否通告 LLDP 802.3at 或 bt 电源管理 TLV。默认情况下,会通告此 TLV。

此命令仅在物理接口上受支持,而不在逻辑接口上受支持。

power_management

布尔值

此命令可用于选择是否通告电源管理 LLDP TLV。默认情况下,会通告电源管理 LLDP TLV。

选择

  • false

  • true

tlv_set

字典

此命令可用于配置 IPv4 或 IPv6 管理地址,该地址将用于通过接口上的 LLDP 通告

此命令仅在物理接口上受支持,而不在逻辑接口上受支持。

ipv4_management_address

字符串

以 A.B.C.D 格式为 LLDP 配置 IPv4 管理地址

ipv6_management_address

字符串

以 A:B::C:D 格式为 LLDP 配置 IPv6 管理地址

state

字符串

state 指定要在设备上执行的配置更新类型。

如果状态为“merged”,则将指定的属性与现有配置属性合并。

对于“deleted”,从现有配置中删除指定的属性。

对于“replaced”,使用提供的配置替换指定接口的 LLDP 接口配置。

对于“overridden”,使用提供的配置覆盖所有设备上的 LLDP 接口配置。

选择

  • "merged" ←(默认)

  • "deleted"

  • "replaced"

  • "overridden"

示例

# Using deleted
#
# Before State:
# -------------
# sonic# show running-configuration interface Ethernet 1
# !
# interface Ethernet1
#  mtu 9100
#  speed 25000
#  unreliable-los auto
#  no shutdown
#  lldp transmit
#  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
          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
#
# 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
          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
# sonic#


# Using deleted
#
# 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
# !
# interface Ethernet1
#  mtu 9100
#  speed 25000
#  unreliable-los auto
#  no shutdown
#  lldp transmit
#  lldp tlv-set management-address ipv4 21.1.1.1
# !
# sonic#

  - name: Delete default LLDP Interface configurations
    dellemc.enterprise_sonic.sonic_lldp_interfaces:
      config:
        - 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
#
# 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
          med_tlv_select:
            power_management: true
          tlv_set:
            ipv4_management_address: 10.1.1.2
      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
#  lldp tlv-set management-address ipv4 10.1.1.2
# sonic#

# Using replaced
#
# 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
#
# !
# 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
      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
# !
# 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
#
# 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'
      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
# !
# interface Eth1/6
#  mtu 9100
#  speed 10000
#  unreliable-los auto
#  no shutdown

返回值

常见的返回值记录在此处,以下是此模块特有的字段

描述

after

列表 / 元素=字符串

生成的配置模块调用。

返回:当更改时

示例:["返回的配置将始终采用与上述参数相同的格式。\n"]

before

列表 / 元素=字符串

模块调用之前的配置。

返回:总是

示例:["返回的配置将始终采用与上述参数相同的格式。\n"]

commands

列表 / 元素=字符串

推送到远程设备的命令集。

返回:总是

示例:["命令 1", "命令 2", "命令 3"]

作者

  • Divya Balasubramanian(@divya-balasubramania)