Модуль dellemc.enterprise_sonic.sonic_qos_interfaces — Управление конфигурацией интерфейсов QoS на SONiC

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет 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
name string / required	Имя интерфейса
pfc dictionary	Конфигурация PFC
asymmetric boolean	Включить или отключить асимметричный PFC на интерфейсе Варианты: `false` ← (default) `true`
priorities list / elements=dictionary	Конфигурация приоритетов PFC
dot1p integer / required	Значение DOT1P, диапазон 0-7 Поддерживается максимум 2 приоритета
enable boolean	Включить или отключить приоритет Варианты: `false` ← (default) `true`
watchdog_action string	Действие при переполнении PFC watchdog Варианты: `"drop"` ← (default) `"forward"` `"alert"`
watchdog_detect_time integer	Время обнаружения PFC watchdog в миллисекундах, диапазон 100-5000
watchdog_restore_time integer	Время восстановления PFC watchdog в миллисекундах, диапазон 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 / required	Идентификатор очереди Диапазон 0-7 для очередей интерфейса, диапазон 0-47 для очередей CPU
wred_profile string	Имя профиля WRED
scheduler_policy string	Имя политики планировщика, которая будет применена к трафику на интерфейсе

state

string

Состояние конфигурации после завершения модуля

Для этого модуля не поддерживаются состояния, которые заменяются и переопределяются из-за ограничений конфигурации

Выбираемые значения:

"merged" ← (по умолчанию)
"deleted"

Примечания

Примечание

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

Примеры

# Using Merged
#
# 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
        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
#  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
#
# 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
#  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
#  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
        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
#  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
#  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 список / элементы=строка	Результирующая конфигурация после вызова модуля. Возвращается: при изменении, если `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"]`

Авторы

Shade Talabi (@stalabi1)

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

© 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/dellemc/enterprise_sonic/sonic_qos_interfaces_module.html