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

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

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

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

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

Параметры

Параметр	Комментарии
config list / elements=dictionary	Список конфигураций сетевых политик
applications list / elements=dictionary	Список конфигураций приложений сетевой политики dot1p и vlan_id являются взаимоисключающими параметрами Параметр dot1p нельзя настроить, если untagged=True
app_type string / обязательный	Тип носителя приложения Варианты: `"voice"` `"voice-signaling"`
dot1p string	Включить тегирование приоритета dot1p Варианты: `"enabled"`
dscp integer	Значение DSCP VLAN, диапазон 0–63
priority integer	Приоритет VLAN, диапазон 0–7
untagged boolean	Указывает, что приложение использует VLAN без тегирования Варианты: `false` `true`
vlan_id integer	Идентификатор VLAN, диапазон 1–4094
number integer / обязательный	Номер сетевой политики, диапазон 1–128
state string	Состояние конфигурации после завершения работы модуля Варианты: `"merged"` ← (по умолчанию) `"deleted"` `"replaced"` `"overridden"`

Примечания

Примечание

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

Примеры

# Using "merged" state
#
# Before state:
# -------------
#
# sonic# show running-configuration
# (No network policy configuration present)

- name: Merge network policy configuration
  dellemc.enterprise_sonic.sonic_network_policy:
    config:
      - number: 1
        applications:
          - app_type: voice
            vlan_id: 2
            priority: 1
            dscp: 1
          - app_type: voice-signaling
            dot1p: enabled
            dscp: 50
    state: merged

# After state:
# ------------
#
# sonic# show running-configuration
# !
# network-policy profile 1
#  voice vlan 2 cos 1 dscp 1
#  voice-signaling vlan dot1p dscp 50
# !


# Using "replaced" state
#
# Before state:
# -------------
#
# sonic# show running-configuration
# !
# network-policy profile 1
#  voice vlan 2 cos 1 dscp 1
#  voice-signaling vlan 3 untagged dscp 50
# !
# network-policy profile 2
#  voice vlan 100 cos 7 dscp 12
#  voice-signaling vlan 400 cos 7 dscp 45
# !

- name: Replace network policy configuration
  dellemc.enterprise_sonic.sonic_network_policy:
    config:
      - number: 1
        applications:
          - app_type: voice
            vlan_id: 1
            untagged: false
            priority: 0
            dscp: 0
    state: replaced

# After state:
# ------------
#
# sonic# show running-configuration
# !
# network-policy profile 1
#  voice vlan 1 cos 0 dscp 0
# !
# network-policy profile 2
#  voice vlan 100 cos 7 dscp 12
#  voice-signaling vlan 400 cos 7 dscp 45
# !


# Using "overridden" state
#
# Before state:
# -------------
#
# sonic# show running-configuration
# !
# network-policy profile 1
#  voice vlan 2 cos 1 dscp 1
#  voice-signaling vlan 3 untagged dscp 50
# !
# network-policy profile 2
#  voice vlan 100 cos 7 dscp 12
#  voice-signaling vlan 400 cos 7 dscp 45
# !

- name: Override network policy configuration
  dellemc.enterprise_sonic.sonic_network_policy:
    config:
      - number: 1
        applications:
          - app_type: voice
            vlan_id: 1
            untagged: false
            priority: 0
            dscp: 0
    state: overridden

# After state:
# ------------
#
# sonic# show running-configuration
# !
# network-policy profile 1
#  voice vlan 1 cos 0 dscp 0
# !


# Using "deleted" state
#
# Before state:
# -------------
#
# sonic# show running-configuration
# !
# network-policy profile 1
#  voice vlan 2 cos 1 dscp 1
#  voice-signaling vlan 3 untagged dscp 50
# !
# network-policy profile 2
#  voice vlan 100 cos 7 dscp 12
#  voice-signaling vlan 400 cos 7 dscp 45
# !
# network-policy profile 3
#  voice-signaling vlan 80 cos 6 dscp 32
# !

- name: Delete network policy configuration
  dellemc.enterprise_sonic.sonic_network_policy:
    config:
      - number: 1
        applications:
          - app_type: voice
            dscp: 1
      - number: 2
        applications:
          - app_type: voice
      - number: 3
    state: deleted

# After state:
# ------------
#
# sonic# show running-configuration
# !
# network-policy profile 1
#  voice vlan 2 cos 1
#  voice-signaling vlan 3 untagged dscp 50
# !
# network-policy profile 2
#  voice-signaling vlan 400 cos 7 dscp 45
# !


# Using "deleted" state
#
# Before state:
# -------------
#
# sonic# show running-configuration
# !
# network-policy profile 1
#  voice vlan 2 cos 1 dscp 1
#  voice-signaling vlan 3 untagged dscp 50
# !
# network-policy profile 2
#  voice vlan 100 cos 7 dscp 12
#  voice-signaling vlan 400 cos 7 dscp 45
# !
# network-policy profile 3
#  voice-signaling vlan 80 cos 6 dscp 32
# !

- name: Delete all network policy configuration
  dellemc.enterprise_sonic.sonic_network_policy:
    config:
    state: deleted

# After state:
# ------------
#
# sonic# show running-configuration
# (No network policy configuration present)

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

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

Ключ	Описание
after list / elements=string	Конфигурация, полученная в результате вызова модуля. Возвращается: при изменении
after(generated) list / elements=string	Конфигурация, сформированная при вызове модуля. Возвращается: когда `check_mode`
before list / elements=string	Конфигурация до вызова модуля. Возвращается: всегда
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_network_policy_module.html