Модуль dellemc.enterprise_sonic.sonic_qos_interfaces — управление конфигурацией интерфейсов QoS в 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_qos_interfaces.

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

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

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

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

Параметры

Параметр	Комментарии
config list / elements=dictionary	Конфигурация интерфейсов QoS
cable_length string добавлено в dellemc.enterprise_sonic 3.1.0	Длина кабеля интерфейса Варианты: `"5m"` `"40m"` ← (по умолчанию) `"300m"`
name string / обязательный	Имя интерфейса
pfc dictionary	Конфигурация PFC
asymmetric boolean	Включить или отключить асимметричный PFC на интерфейсе Варианты: `false` ← (по умолчанию) `true`
priorities list / elements=dictionary	Конфигурация приоритетов PFC
dot1p integer / обязательный	Значение DOT1P, диапазон 0–7 Поддерживается не более 2 приоритетов
enable boolean	Включить или отключить приоритет Варианты: `false` ← (по умолчанию) `true`
watchdog_action string	Действие сторожевого таймера PFC при перегрузке Варианты: `"drop"` ← (по умолчанию) `"forward"` `"alert"`
watchdog_detect_time integer	Время обнаружения сторожевым таймером PFC в миллисекундах, диапазон 100–5000
watchdog_restore_time integer	Время восстановления сторожевого таймера PFC в миллисекундах, диапазон 100–60000
qos_maps dictionary	Конфигурация карт QoS интерфейса
dot1p_fwd_group string	Карта преобразования DOT1P в группу пересылки, связанная с интерфейсом
dscp_fwd_group string	Карта преобразования DSCP в группу пересылки, связанная с интерфейсом
fwd_group_dot1p string	Карта преобразования группы пересылки в DOT1P, связанная с интерфейсом
fwd_group_dscp string	Карта преобразования группы пересылки в DSCP, связанная с интерфейсом
fwd_group_pg string	Карта преобразования группы пересылки в группу приоритетов, связанная с интерфейсом
fwd_group_queue string	Карта преобразования группы пересылки в очередь, связанная с интерфейсом
pfc_priority_pg string	Карта преобразования приоритета PFC в группу приоритетов, связанная с интерфейсом
pfc_priority_queue string	Карта преобразования приоритета PFC в очередь, связанная с интерфейсом
queues list / elements=dictionary	Конфигурация очередей
id integer / обязательный	Идентификатор очереди Диапазон 0–7 для очередей интерфейса, диапазон 0–47 для очередей ЦП
wred_profile string	Имя профиля WRED
scheduler_policy string	Имя политики планировщика, применяемой к трафику интерфейса
state string	Состояние конфигурации после выполнения модуля Состояния replaced и overridden не поддерживаются этим модулем из-за ограничений конфигурации Варианты: `"merged"` ← (по умолчанию) `"deleted"`

Примечания

Примечание

Проверено на Enterprise SONiC Distribution компании Dell Technologies.
Поддерживает check_mode.

Примеры

# Using "merged" state
#
# Before state:
# -------------
#
# sonic# show running-configuration interface Eth 1/5
# !
# interface Eth1/5
# (No QoS configuration present for the interface)

- name: Merge QoS interfaces configuration
  dellemc.enterprise_sonic.sonic_qos_interfaces:
    config:
      - name: Eth1/5
        queues:
          - id: 0
            wred_profile: profile1
        scheduler_policy: policy1
        cable_length: 40m
        qos_maps:
          dscp_fwd_group: dscp_map1
          dot1p_fwd_group: dot1p_map1
          fwd_group_dscp: fwd_dscp_map1
          fwd_group_dot1p: fwd_dot1p_map1
          fwd_group_queue: fwd_queue_map1
          fwd_group_pg: fwd_pg_map1
          pfc_priority_queue: pfc_queue_map1
          pfc_priority_pg: pfc_pg_map1
        pfc:
          asymmetric: true
          watchdog_action: alert
          watchdog_detect_time: 100
          watchdog_restore_time: 200
          priorities:
            - dot1p: 0
              enable: true
            - dot1p: 1
              enable: true
    state: merged

# After state:
# ------------
#
# sonic# show running-configuration interface Eth 1/5
# !
# interface Eth1/5
#  queue 0 wred-policy profile1
#  scheduler-policy policy1
#  cable-length 40m
#  qos-map dscp-tc dscp_map1
#  qos-map dot1p-tc dot1p_map1
#  qos-map tc-queue fwd_queue_map1
#  qos-map tc-pg fwd_pg_map1
#  qos-map tc-dscp fwd_dscp_map1
#  qos-map tc-dot1p fwd_dot1p_map1
#  qos-map pfc-priority-queue pfc_queue_map1
#  qos-map pfc-priority-pg pfc_pg_map1
#  priority-flow-control priority 0
#  priority-flow-control priority 1
#  priority-flow-control asymmetric
#  priority-flow-control watchdog action alert
#  priority-flow-control watchdog on detect-time 100
#  priority-flow-control watchdog restore-time 200
#
#
# Using "deleted" state
#
# Before state:
# -------------
#
# sonic# show running-configuration interface Eth 1/5
# !
# interface Eth1/5
#  queue 0 wred-policy profile2
#  queue 1 wred-policy profile1
#  scheduler-policy policy2
#  cable-length 5m
#  qos-map dscp-tc dscp_map2
#  qos-map dot1p-tc dot1p_map2
#  qos-map tc-queue fwd_queue_map2
#  qos-map tc-pg fwd_pg_map2
#  qos-map tc-dscp fwd_dscp_map2
#  qos-map tc-dot1p fwd_dot1p_map2
#  qos-map pfc-priority-queue pfc_queue_map1
#  qos-map pfc-priority-pg pfc_pg_map1
#  priority-flow-control priority 1
#  priority-flow-control watchdog action drop
#  priority-flow-control watchdog on detect-time 150
#  priority-flow-control watchdog restore-time 250
# sonic# show running-configuration interface Eth 1/6
# !
# interface Eth1/6
#  queue 0 wred-policy profile1
#  scheduler-policy policy1
#  cable-length 40m
#  qos-map dscp-tc dscp_map1
#  qos-map dot1p-tc dot1p_map1
#  qos-map tc-queue fwd_queue_map1
#  qos-map tc-pg fwd_pg_map1
#  qos-map tc-dscp fwd_dscp_map1
#  qos-map tc-dot1p fwd_dot1p_map1
#  qos-map pfc-priority-queue pfc_queue_map1
#  qos-map pfc-priority-pg pfc_pg_map1
#  priority-flow-control priority 0
#  priority-flow-control asymmetric
#  priority-flow-control watchdog on detect-time 100
#  priority-flow-control watchdog restore-time 200

- name: Delete QoS interfaces attributes
  dellemc.enterprise_sonic.sonic_interfaces:
    config:
      - name: Eth1/5
        queues:
          - id: 0
            wred_profile: profile2
          - id: 1
        scheduler_policy: policy2
        cable_length: 5m
        qos_maps:
          dscp_fwd_group: dscp_map2
          dot1p_fwd_group: dot1p_map2
          fwd_group_dscp: fwd_dscp_map2
          fwd_group_dot1p: fwd_dot1p_map2
          fwd_group_queue: fwd_queue_map2
          fwd_group_pg: fwd_pg_map2
      - name: Eth1/6
        pfc:
          asymmetric: true
          watchdog_action: drop
          watchdog_detect_time: 100
          watchdog_restore_time: 200
          priorities:
            - dot1p: 0
              enable: true
            - dot1p: 1
              enable: true
    state: deleted

# After state:
# ------------
#
# sonic# show running-configuration interface Eth 1/5
# !
# interface Eth1/5
#  cable-length 40m
#  qos-map pfc-priority-queue pfc_queue_map1
#  qos-map pfc-priority-pg pfc_pg_map1
#  priority-flow-control priority 1
#  priority-flow-control watchdog action drop
#  priority-flow-control watchdog on detect-time 150
#  priority-flow-control watchdog restore-time 250
# sonic# show running-configuration interface Eth 1/6
# !
# interface Eth1/6
#  queue 0 wred-policy profile1
#  scheduler-policy policy1
#  cable-length 40m
#  qos-map dscp-tc dscp_map1
#  qos-map dot1p-tc dot1p_map1
#  qos-map tc-queue fwd_queue_map1
#  qos-map tc-pg fwd_pg_map1
#  qos-map tc-dscp fwd_dscp_map1
#  qos-map tc-dot1p fwd_dot1p_map1
#  qos-map pfc-priority-queue pfc_queue_map1
#  qos-map pfc-priority-pg pfc_pg_map1

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

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

Ключ	Описание
after list / elements=string	Конфигурация, полученная в результате вызова модуля. Возвращается: при наличии изменений, если `check_mode` не задано Пример: `["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 as 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"]`

Авторы

1. Talabi (@stalabi1)

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

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