Модуль dellemc.enterprise_sonic.sonic_qos_buffer — управление конфигурацией буфера 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_buffer.

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

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

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

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

Параметры

Параметр	Комментарии
config словарь	Конфигурация буфера QoS
buffer_init логическое значение добавлено в dellemc.enterprise_sonic 3.0.0	Инициализация буфера QoS на основе системных значений по умолчанию Варианты: `false` `true`
buffer_pools список / элементы=словарь	Конфигурация пулов буфера
name строка / обязательный	Имя пула буфера Варианты: `"ingress_lossless_pool"`
xoff целое число	Объём общего пространства буфера в байтах; должен быть меньше размера пула Обязательный атрибут, не являющийся ключом
buffer_profiles список / элементы=словарь	Конфигурация профилей буфера static_threshold и dynamic_threshold — взаимоисключающие обязательные атрибуты, не являющиеся ключами
dynamic_threshold целое число	Значение динамического порога Диапазон: -6–3
name строка / обязательный	Имя профиля буфера
pause_threshold целое число	Пороговое значение, при достижении которого передача трафика от соседнего устройства останавливается Диапазон: 46080–8388608 Настраивается для входящего пула без потерь
pool строка	Имя пула буфера Обязательный атрибут, не являющийся ключом Варианты: `"ingress_lossless_pool"` `"egress_lossless_pool"` `"egress_lossy_pool"`
size целое число	Размер зарезервированного буфера в байтах Обязательный атрибут, не являющийся ключом
static_threshold целое число	Статический порог для совместного использования в байтах
state строка	Состояние конфигурации после выполнения модуля Состояния replaced и overridden не поддерживаются этим модулем из-за ограничений конфигурации Варианты: `"merged"` ← (по умолчанию) `"deleted"`

Примечания

Примечание

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

Примеры

# Using "merged" state
#
# Before state:
# -------------
#
# sonic# show running-configuration | grep buffer
# buffer init lossless
# buffer pool ingress_lossless_pool shared-headroom-size 1000000

- name: Merge QoS buffer configuration
  dellemc.enterprise_sonic.sonic_qos_buffer:
    config:
      buffer_init: true
      buffer_pools:
        - name: ingress_lossless_pool
          xoff: 3500000
      buffer_profiles:
        - name: profile1
          pool: ingress_lossless_pool
          size: 45
          static_threshold: 25
          pause_threshold: 55000
        - name: profile2
          pool: egress_lossless_pool
          size: 85
          dynamic_threshold: -2
        - name: profile3
          pool: egress_lossy_pool
          size: 90
          static_threshold: 30
    state: merged

# After state:
# ------------
#
# sonic# show running-configuration | grep buffer
# buffer init lossless
# buffer pool ingress_lossless_pool shared-headroom-size 3500000
# buffer profile profile1 ingress_lossless_pool 45 static-threshold 25 pause pause-threshold 55000
# buffer profile profile2 egress_lossy_pool 85 dynamic-threshold -2
# buffer profile profile3 egress_lossless_pool 90 static-threshold 30
#
#
# Using "deleted" state
#
# Before state:
# -------------
#
# sonic# show running-configuration | grep buffer
# buffer init lossless
# buffer pool ingress_lossless_pool shared-headroom-size 3500000
# buffer profile profile1 ingress_lossless_pool 45 static-threshold 25 pause pause-threshold 55000
# buffer profile profile2 egress_lossy_pool 85 dynamic-threshold -2
# buffer profile profile3 egress_lossless_pool 90 static-threshold 30

- name: Delete QoS buffer profile configuration
  dellemc.enterprise_sonic.sonic_qos_buffer:
    config:
      buffer_profiles:
        - name: profile1
          static_threshold: 25
          pause_threshold: 55000
        - name: profile2
          dynamic_threshold: -2
        - name: profile3
    state: deleted

# After state:
# ------------
#
# sonic# show running-configuration | grep buffer
# buffer init lossless
# buffer pool ingress_lossless_pool shared-headroom-size 3500000
# buffer profile profile1 ingress_lossless_pool 45
# buffer profile profile2 egress_lossy_pool 85

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

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

Ключ	Описание
after список / элементы=строка	Итоговый вызов модели конфигурации. Возвращается: при изменении Пример: `["The configuration returned will always be in the same format of the parameters above.\n"]`
after(generated) список / элементы=строка	Сгенерированный вызов модели конфигурации. Возвращается: когда `check_mode` Пример: `["The configuration returned will always be in the same format\n of the parameters above.\n"]`
before список / элементы=строка	Конфигурация до вызова модели. Возвращается: всегда Пример: `["The configuration returned will always be in the same format of the parameters above.\n"]`
commands список / элементы=строка	Набор команд, переданных на удалённое устройство. Возвращается: всегда Пример: `["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_buffer_module.html