модуль dellemc.enterprise_sonic.sonic_vlan_mapping — настройка сопоставлений VLAN в 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_vlan_mapping.

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

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

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

Этот модуль управляет конфигурацией сопоставлений VLAN на устройствах под управлением SONiC.
Сопоставления VLAN доступны только на устройствах TD3 и TD4.
На устройствах TD4 сначала необходимо включить сопоставление VLAN (это можно сделать в config-switch-resource).

Параметры

Параметр	Комментарии
config список / элементы=словарь	Задаёт параметры конфигурации, связанные с сопоставлением VLAN.
mapping список / элементы=словарь	Задаёт сопоставления VLAN. dot1q_tunnel и vlan_translation взаимоисключающие.
dot1q_tunnel словарь	Задаёт стек VLAN.
priority целое число	Задаёт уровень приоритета стека VLAN. Диапазон приоритетов: 0–7.
vlan_ids список / элементы=строка	Настраивает идентификаторы VLAN клиента. Можно указать диапазоны и/или несколько элементов списка. Отдельный идентификатор VLAN или диапазон идентификаторов VLAN, разделённых дефисом (-).
service_vlan целое число / обязательный	Настраивает идентификатор VLAN поставщика услуг. Диапазон идентификаторов VLAN: 1–4094.
vlan_translation словарь добавлено в dellemc.enterprise_sonic 3.0.0	Задаёт преобразование VLAN.
match_double_tags список / элементы=словарь	Настраивает преобразование VLAN с двойной маркировкой.
inner_vlan целое число / обязательный	Настраивает идентификатор внутренней VLAN клиента. Диапазон идентификаторов VLAN: 1–4094. Доступно только для преобразований с двойной маркировкой.
outer_vlan целое число / обязательный	Настраивает идентификатор внешней VLAN клиента. Диапазон идентификаторов VLAN: 1–4094.
priority целое число	Задаёт уровень приоритета преобразования VLAN. Диапазон приоритетов: 0–7.
match_single_tags список / элементы=словарь	Настраивает преобразование VLAN с одинарной маркировкой.
outer_vlan целое число / обязательный	Настраивает идентификатор внешней VLAN клиента. Диапазон идентификаторов VLAN: 1–4094.
priority целое число	Задаёт уровень приоритета преобразования VLAN. Диапазон приоритетов: 0–7.
multi_tag логическое значение	Указывает, используется ли несколько меток. Варианты: `false` `true`
name строка / обязательный	Полное имя интерфейса, например Ethernet8, PortChannel2, Eth1/2.
state строка	Задаёт операцию, которая будет выполнена над настроенными на устройстве сопоставлениями VLAN. При значении merged входная конфигурация будет объединена с существующими сопоставлениями VLAN на устройстве. При значении deleted существующая конфигурация сопоставления VLAN будет удалена с устройства. При значении overridden все существующие сопоставления VLAN будут удалены, а указанная входная конфигурация будет добавлена. При значении replaced существующие сопоставления VLAN на устройстве будут заменены конфигурацией для каждого сопоставления VLAN. Варианты: `"merged"` ← (по умолчанию) `"deleted"` `"replaced"` `"overridden"`

Примеры

#
# Using "deleted" state
#
# Before state:
# -------------
#
# sonic# show interface vlan-mappings dot1q-tunnel
# --------------------------------------------------------------------
# Name            Vlan                     dot1q-tunnel Vlan  Priority
# --------------------------------------------------------------------
# Ethernet4       360-366,392              2755               3
#
#  - name: Delete dot1q_tunnel configuration
#    sonic_vlan_mapping:
#      config:
#        - name: Ethernet4
#          mapping:
#            - service_vlan: 2755
#              dot1q_tunnel:
#                vlan_ids:
#                  - 392
#                  - 360-362
#      state: deleted
#
# After state:
# ------------
#
# sonic# show interface vlan-mappings dot1q-tunnel
# --------------------------------------------------------------------
# Name            Vlan                     dot1q-tunnel Vlan  Priority
# --------------------------------------------------------------------
# Ethernet4       363-366                  2755               3
#
# Using "deleted" state
#
# Before state:
# -------------
#
# sonic# show interface vlan-mappings
# Flags: M - Multi-tag
# ---------------------------------------------------------
# Name            Outer  Inner  Mapped Vlan  Priority Flags
# ---------------------------------------------------------
# Ethernet8       610    600    2567         -        -
# Ethernet8       611    601    2567         1        -
# Ethernet8       612    602    2567         2        -
#
#  - name: Delete vlan translation configuration
#    sonic_vlan_mapping:
#      config:
#        - name: Ethernet8
#          mapping:
#          - service_vlan: 2567
#            vlan_translation:
#              match_double_tags:
#                - inner_vlan: 602
#                  outer_vlan: 612
#                  priority: 2
#      state: deleted
#
# After state:
# ------------
#
# sonic# show interface vlan-mappings
# Flags: M - Multi-tag
# ---------------------------------------------------------
# Name            Outer  Inner  Mapped Vlan  Priority Flags
# ---------------------------------------------------------
# Ethernet8       610    600    2567         -        -
# Ethernet8       611    601    2567         1        -
#
#
# Using "merged" state
#
# Before state:
# -------------
#
# sonic# show interface vlan-mappings dot1q-tunnel
#
#  - name: Merge dot1q_tunnel configuration
#    sonic_vlan_mapping:
#      config:
#        - name: Ethernet4
#          mapping:
#            - service_vlan: 2755
#              dot1q_tunnel:
#                vlan_ids:
#                  - 392
#                  - 360-366
#                priority: 3
#      state: merged
#
# After state:
# ------------
#
# sonic# show interface vlan-mappings dot1q-tunnel
# --------------------------------------------------------------------
# Name            Vlan                     dot1q-tunnel Vlan  Priority
# --------------------------------------------------------------------
# Ethernet4       360-366,392              2755               3
#
# Using "merged" state
#
# Before state:
# -------------
#
# sonic# show interface vlan-mappings dot1q-tunnel
# --------------------------------------------------------------------
# Name            Vlan                     dot1q-tunnel Vlan  Priority
# --------------------------------------------------------------------
# Ethernet4       360-366,392              2755               3
#
#  - name: Merge vlan translation configuration
#    sonic_vlan_mapping:
#      config:
#        - name: Ethernet8
#          mapping:
#          - service_vlan: 2567
#            vlan_translation:
#              match_double_tags:
#                - inner_vlan: 600
#                  outer_vlan: 610
#                - inner_vlan: 601
#                  outer_vlan: 611
#                  priority: 1
#                - inner_vlan: 602
#                  outer_vlan: 612
#                  priority: 2
#      state: merged
#
# After state:
# ------------
#
# sonic# show interface vlan-mappings
# Flags: M - Multi-tag
# ---------------------------------------------------------
# Name            Outer  Inner  Mapped Vlan  Priority Flags
# ---------------------------------------------------------
# Ethernet8       610    600    2567         -        -
# Ethernet8       611    601    2567         1        -
# Ethernet8       612    602    2567         2        -
#
# sonic# show interface vlan-mappings dot1q-tunnel
# --------------------------------------------------------------------
# Name            Vlan                     dot1q-tunnel Vlan  Priority
# --------------------------------------------------------------------
# Ethernet4       360-366,392              2755               3
#
#
# Using "replaced" state
#
# Before state:
# -------------
#
# sonic# show interface vlan-mappings dot1q-tunnel
# --------------------------------------------------------------------
# Name            Vlan                     dot1q-tunnel Vlan  Priority
# --------------------------------------------------------------------
# Ethernet4       360-366,392              2755               3
#
#  - name: Replace dot1q_tunnel configuration
#    sonic_vlan_mapping:
#      config:
#        - name: Ethernet4
#          mapping:
#            - service_vlan: 2755
#              dot1q_tunnel:
#                vlan_ids:
#                  - 660-666
#                priority: 6
#      state: replaced
#
# After state:
# ------------
#
# sonic# show interface vlan-mappings dot1q-tunnel
# --------------------------------------------------------------------
# Name            Vlan                     dot1q-tunnel Vlan  Priority
# --------------------------------------------------------------------
# Ethernet4       660-666                  2755               6
#
# Using "overridden" state
#
# Before state:
# -------------
#
# sonic# show interface vlan-mappings
# Flags: M - Multi-tag
# ---------------------------------------------------------
# Name            Outer  Inner  Mapped Vlan  Priority Flags
# ---------------------------------------------------------
# Ethernet8       610    600    2567         -        -
# Ethernet8       611    601    2567         1        -
# Ethernet8       612    602    2567         2        -
#
#  - name: Override vlan translation configuration
#    sonic_vlan_mapping:
#      config:
#        - name: Ethernet8
#          mapping:
#          - service_vlan: 2567
#            vlan_translation:
#              match_double_tags:
#                - inner_vlan: 701
#                  outer_vlan: 711
#                  priority: 5
#                - inner_vlan: 702
#                  outer_vlan: 712
#                  priority: 6
#      state: overridden
#
# After state:
# ------------
#
# sonic# show interface vlan-mappings
# Flags: M - Multi-tag
# ---------------------------------------------------------
# Name            Outer  Inner  Mapped Vlan  Priority Flags
# ---------------------------------------------------------
# Ethernet8       711    701    2567         5        -
# Ethernet8       712    702    2567         6        -
#

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

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

Ключ	Описание
after список / элементы=строка	Итоговая конфигурация после вызова модуля. Возвращается: при наличии изменений Пример: `["The configuration returned will always be in the same format 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"]`

Авторы

Cypher Miller (@Cypher-Miller)

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

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