модуль dellemc.enterprise_sonic.sonic_dcbx — управление конфигурациями DCBx в 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_dcbx.

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

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

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

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

Параметры

Параметр	Комментарии
config словарь	Набор конфигураций атрибутов DCBx
global словарь	Глобальная конфигурация DCBx
enabled логическое значение	Этот аргумент принимает логическое значение, которое включает или отключает DCBx. В SONiC по умолчанию установлено значение False, а рабочее значение по умолчанию для коллекции Ansible enterprise_sonic — False Варианты: `false` `true`
interfaces список / элементы=словарь	Конфигурация DCBx интерфейсов
enabled логическое значение	Этот аргумент принимает логическое значение, которое включает или отключает DCBx. В SONiC по умолчанию установлено значение True, а рабочее значение по умолчанию для коллекции Ansible enterprise_sonic — True Эта команда поддерживается только на физических интерфейсах, но не на логических. Варианты: `false` `true`
ets_configuration_tlv_enabled логическое значение	Эту команду можно использовать, чтобы указать, следует ли объявлять и принимать TLV конфигурации ETS. В SONiC по умолчанию установлено значение True, а рабочее значение по умолчанию для коллекции Ansible enterprise_sonic — True Варианты: `false` `true`
ets_recommendation_tlv_enabled логическое значение	Эту команду можно использовать, чтобы указать, следует ли объявлять и принимать TLV рекомендаций ETS. В SONiC по умолчанию установлено значение True, а рабочее значение по умолчанию для коллекции Ansible enterprise_sonic — True Варианты: `false` `true`
name строка / обязательный	Имя интерфейса, для которого необходимо настроить DCBx. Это должен быть физический интерфейс (Ethernet).
pfc_tlv_enabled логическое значение	Эту команду можно использовать, чтобы указать, следует ли объявлять и принимать TLV PFC. В SONiC по умолчанию установлено значение True, а рабочее значение по умолчанию для коллекции Ansible enterprise_sonic — True Варианты: `false` `true`
state строка	Параметр состояния задаёт тип обновления конфигурации, которое необходимо выполнить на устройстве. Если состояние — «merged», указанные атрибуты объединяются с уже настроенными атрибутами. Если состояние — «deleted», указанные атрибуты удаляются из существующей конфигурации. Варианты: `"merged"` ← (по умолчанию) `"deleted"` `"replaced"` `"overridden"`

Примеры

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

- name: Modify DCBx Interface configurations
  dellemc.enterprise_sonic.sonic_dcbx:
    config:
      -interfaces:
        - name: Ethernet0
          enabled: false
          pfc_tlv_enabled: false
          ets_configuration_tlv_enabled: false
          ets_recommendation_tlv_enabled: false
    state: merged

# After State:
# ------------
#
# sonic# show running-configuration interface Ethernet0
# !
# interface Ethernet0
#  mtu 9100
#  speed 25000
#  unreliable-los auto
#  no shutdown
#  no dcbx enable
#  no dcbx tlv-select pfc
#  no dcbx tlv-select ets-conf
#  no dcbx tlv-select ets-reco

# Using "merged" state for DCBx global configuration
#
# Before State:
# -------------
#
# sonic# show running-configuration | grep dcbx
# sonic#

- name: Modify DCBX configurations
  dellemc.enterprise_sonic.sonic_dcbx:
    config:
      global:
        enabled: true
    state: merged

# After State:
# ------------
#
# sonic# show running-configuration | grep dcbx
# !
# dcbx enable
# !

# Using "merged" state for DCBx interface configuration
#
# Before State:
# -------------
# sonic# show running-configuration interface Ethernet 0
# !
# interface Ethernet0
#  mtu 9100
#  speed 25000
#  unreliable-los auto
#  no shutdown
#  no dcbx enable
#  no dcbx tlv-select pfc
#  no dcbx tlv-select ets-conf
#  no dcbx tlv-select ets-reco


- name: Modify DCBx Interface configurations
  dellemc.enterprise_sonic.sonic_dcbx:
    config:
      interfaces:
        - name: Ethernet0
          enabled: true
          pfc_tlv_enabled: true
          ets_configuration_tlv_enabled: true
          ets_recommendation_tlv_enabled: true
    state: merged

# After State:
# ------------
#
# sonic# show running-configuration interface Ethernet0
# !
# interface Ethernet0
#  mtu 9100
#  speed 25000
#  unreliable-los auto
#  no shutdown

# Using "deleted" state for DCBx interface configuration
#
# Before State:
# -------------
#
# sonic# show running-configuration interface Ethernet 0
# !
# interface Ethernet0
#  mtu 9100
#  speed 25000
#  unreliable-los auto
#  no shutdown
#  no dcbx enable
#  no dcbx tlv-select pfc
#  no dcbx tlv-select ets-conf
#  no dcbx tlv-select ets-reco


- name: Delete and set default DCBx Interface configurations
  dellemc.enterprise_sonic.sonic_dcbx:
    config:
      interfaces:
        - name: Ethernet0
          enabled: false
          pfc_tlv_enabled: false
          ets_configuration_tlv_enabled: false
          ets_recommendation_tlv_enabled: false
    state: deleted

# After State:
# ------------
#
# sonic# show running-configuration interface Ethernet0
# !
# interface Ethernet0
#  mtu 9100
#  speed 25000
#  unreliable-los auto
#  no shutdown

# Using "replaced" state for DCBx interface configuration
#
# Before State:
# -------------
#
# sonic# show running-configuration interface Ethernet0
# !
# interface Ethernet0
#  mtu 9100
#  speed 25000
#  unreliable-los auto
#  no shutdown
#  no dcbx tlv-select pfc
#  no dcbx tlv-select ets-conf
#  no dcbx tlv-select ets-reco
#
# sonic# show running-configuration interface Ethernet4
# !
# interface Ethernet4
#  mtu 9100
#  speed 25000
#  unreliable-los auto
#  no shutdown
#  no dcbx enable
#  no dcbx tlv-select pfc

- name: Modify DCBx Interface configurations
  dellemc.enterprise_sonic.sonic_dcbx:
    config:
      -interfaces:
        - name: Ethernet0
          enabled: false
    state: replaced

# After State:
# ------------
#
# sonic# show running-configuration interface Ethernet0
# !
# interface Ethernet0
#  mtu 9100
#  speed 25000
#  unreliable-los auto
#  no shutdown
#  no dcbx enable
#
# sonic# show running-configuration interface Ethernet4
# !
# interface Ethernet4
#  mtu 9100
#  speed 25000
#  unreliable-los auto
#  no shutdown
#  no dcbx enable
#  no dcbx tlv-select pfc

# Using "overridden" state for DCBx interface configuration
#
# Before State:
# -------------
# sonic# show running-configuration interface Ethernet0
# !
# interface Ethernet0
#  mtu 9100
#  speed 25000
#  unreliable-los auto
#  no shutdown
#  no dcbx tlv-select pfc
#  no dcbx tlv-select ets-conf
#  no dcbx tlv-select ets-reco
#
# sonic# show running-configuration interface Ethernet4
# !
# interface Ethernet4
#  mtu 9100
#  speed 25000
#  unreliable-los auto
#  no shutdown
#  no dcbx enable
#  no dcbx tlv-select pfc
#
# sonic# show running-configuration interface Ethernet8
# !
# interface Ethernet8
#  mtu 9100
#  speed 25000
#  unreliable-los auto
#  no shutdown
#  no dcbx enable
#  no dcbx tlv-select pfc
#  no dcbx tlv-select ets-conf
#  no dcbx tlv-select ets-reco
#
# sonic# show running-configuration interface Ethernet12
# !
# interface Ethernet12
#  mtu 9100
#  speed 25000
#  unreliable-los auto
#  no shutdown

- name: Modify DCBx Interface configurations
  dellemc.enterprise_sonic.sonic_dcbx:
    config:
      -interfaces:
        - name: Ethernet0
          enabled: false
    state: overridden

# After State:
# ------------
# sonic# show running-configuration interface Ethernet0
# !
# interface Ethernet0
#  mtu 9100
#  speed 25000
#  unreliable-los auto
#  no shutdown
#  no dcbx enable
#
# sonic# show running-configuration interface Ethernet4
# !
# interface Ethernet4
#  mtu 9100
#  speed 25000
#  unreliable-los auto
#  no shutdown
#
# sonic# show running-configuration interface Ethernet8
# !
# interface Ethernet8
#  mtu 9100
#  speed 25000
#  unreliable-los auto
#  no shutdown
#
# sonic# show running-configuration interface Ethernet12
# !
# interface Ethernet12
#  mtu 9100
#  speed 25000
#  unreliable-los auto
#  no shutdown

# Using "deleted" state for DCBx global configuration
#
# Before State:
# -------------
#
# sonic# show running-configuration | grep dcbx
# !
# dcbx enable
# !

- name: Delete DCBX mode configuration
  dellemc.enterprise_sonic.sonic_dcbx:
    config:
      global:
        enabled: true
    state: deleted

# After State:
# ------------
#
# sonic# show running-configuration | grep dcbx
# sonic#

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

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

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

Авторы

Bing Sun(@bsun-sudo), Haemanthi Sree KR (@haemanthisree)

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

© 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_dcbx_module.html