Модуль dellemc.enterprise_sonic.sonic_mirroring — управление конфигурацией зеркалирования портов в 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_mirroring.

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

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

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

Параметры

Параметр	Комментарии
config dictionary	Задает конфигурацию зеркалирования портов.
erspan list / elements=dictionary	Сеансы зеркалирования ERSPAN.
direction string	Направление сеанса зеркалирования. Допустимые значения: `"rx"` `"tx"` `"both"`
dscp integer	DSCP назначения ERSPAN. Допустимый диапазон значений: от 0 до 63.
dst_ip string	IP-адрес назначения ERSPAN.
gre string	Тип GRE назначения ERSPAN. Шестнадцатеричная строка вида 0xabcd.
name string / обязательный	Имя сеанса зеркалирования ERSPAN.
queue integer	Номер очереди назначения ERSPAN. Допустимый диапазон значений: от 0 до 63. Поддерживается только очередь 0.
source string	Исходный интерфейс сеанса зеркалирования. Это может быть интерфейс Ethernet или интерфейс PortChannel.
src_ip string	IP-адрес источника ERSPAN.
ttl integer	TTL назначения ERSPAN Допустимый диапазон значений: от 0 до 63.
span list / elements=dictionary	Сеансы зеркалирования SPAN.
direction string	Направление сеанса зеркалирования. Допустимые значения: `"rx"` `"tx"` `"both"`
dst_port string	Интерфейс назначения сеанса зеркалирования. Это может быть CPU или интерфейс Ethernet.
name string / обязательный	Имя сеанса зеркалирования SPAN.
source string	Исходный интерфейс сеанса зеркалирования. Это может быть интерфейс Ethernet или интерфейс PortChannel.
state string	Задает операцию, выполняемую с настроенным на устройстве зеркалированием. При значении merged входная конфигурация объединяется с существующей конфигурацией на устройстве. При значении deleted входная конфигурация удаляется с устройства. При значении overridden вся существующая конфигурация зеркалирования удаляется и добавляется указанная входная конфигурация. При значении replaced существующая конфигурация зеркалирования на устройстве заменяется новой указанной конфигурацией для каждого затронутого сеанса зеркалирования. Допустимые значения: `"merged"` ← (по умолчанию) `"deleted"` `"replaced"` `"overridden"`

Примечания

Примечание

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

Примеры

# Using "deleted" state
#
# Before state:
# -------------
#
# sonic# show mirror-session
# ERSPAN Sessions
# -----------------------------------------------------------------------------------------------------------------------------------------
# Name                     Status     SRC-IP           DST-IP           GRE    DSCP   TTL    Queue    Policer    SRC-Port         Direction
# -----------------------------------------------------------------------------------------------------------------------------------------
# dell-2                   inactive   200.22.22.22     100.11.11.11                          0                   Ethernet28       both
# SPAN Sessions
# -------------------------------------------------------------------------------
# Name                     Status     DST-Port         SRC-Port         Direction
# -------------------------------------------------------------------------------
# dell-1                   active     CPU              Ethernet24       both
# dell-3                   active     CPU

- name: Delete mirroring configuration
  dellemc.enterprise_sonic.sonic_mirroring:
    config:
      span:
        - name: dell-3
      erspan:
        - name: dell-2
    state: deleted

# After state:
# ------------
#
# sonic# show mirror-session
# SPAN Sessions
# -------------------------------------------------------------------------------
# Name                     Status     DST-Port         SRC-Port         Direction
# -------------------------------------------------------------------------------
# dell-1                   active     CPU              Ethernet24       both


# Using "merged" state
#
# Before state:
# -------------
#
# sonic# show mirror-session
# No sessions configured

- name: Merge mirroring configuration
  dellemc.enterprise_sonic.sonic_mirroring:
    config:
      span:
        - name: dell-1
          dst_port: CPU
          source: Ethernet24
          direction: both
      erspan:
        - name: dell-2
          dst_ip: 100.11.11.11
          src_ip: 200.22.22.22
          source: Ethernet28
          direction: both
          queue: 0
    state: merged

# After state:
# ------------
#
# sonic# show mirror-session
# ERSPAN Sessions
# -----------------------------------------------------------------------------------------------------------------------------------------
# Name                     Status     SRC-IP           DST-IP           GRE    DSCP   TTL    Queue    Policer    SRC-Port         Direction
# -----------------------------------------------------------------------------------------------------------------------------------------
# dell-2                   inactive   200.22.22.22     100.11.11.11                          0                   Ethernet28       both
# SPAN Sessions
# -------------------------------------------------------------------------------
# Name                     Status     DST-Port         SRC-Port         Direction
# -------------------------------------------------------------------------------
# dell-1                   active     CPU              Ethernet24       both


# Using "merged" state
#
# Before state:
# -------------
#
# sonic# show mirror-session
# SPAN Sessions
# -------------------------------------------------------------------------------
# Name                     Status     DST-Port         SRC-Port         Direction
# -------------------------------------------------------------------------------
# dell-1                   active     CPU              Ethernet24       both

- name: Modify existing mirroring configuration
  dellemc.enterprise_sonic.sonic_mirroring:
    config:
      span:
        - name: dell-1
          dst_port: Ethernet32
          source: Ethernet4
          direction: rx

# After state:
# ------------
#
# sonic# show mirror-session
# SPAN Sessions
# -------------------------------------------------------------------------------
# Name                     Status     DST-Port         SRC-Port         Direction
# -------------------------------------------------------------------------------
# dell-1                   active     Ethernet32       Ethernet4        rx


# Using "replaced" state
#
# Before state:
# -------------
#
# sonic# show mirror-session
# ERSPAN Sessions
# -----------------------------------------------------------------------------------------------------------------------------------------
# Name                     Status     SRC-IP           DST-IP           GRE    DSCP   TTL    Queue    Policer    SRC-Port         Direction
# -----------------------------------------------------------------------------------------------------------------------------------------
# dell-2                   inactive   200.22.22.22     100.11.11.11                          0                   Ethernet28       both
# SPAN Sessions
# -------------------------------------------------------------------------------
# Name                     Status     DST-Port         SRC-Port         Direction
# -------------------------------------------------------------------------------
# dell-1                   active     CPU              Ethernet24       both
# dell-3                   active     CPU

- name: Replace mirroring configuration
  dellemc.enterprise_sonic.sonic_mirroring:
    config:
      erspan:
        - name: dell-2
          dst_ip: 32.22.22.12
          src_ip: 31.21.21.12
          source: Ethernet28
          dscp: 6
          gre: "0x6689"
          ttl: 9
          queue: 0
          direction: rx
        - name: dell-3
          dst_ip: 22.22.22.12
          src_ip: 21.21.21.12
          source: Ethernet28
          direction: rx
      span:
        - name: dell-1
          dst_port: Ethernet4
          source: Ethernet24
          direction: tx
    state: replaced

# After state:
# ------------
#
# sonic# show mirror-session
# ERSPAN Sessions
# -----------------------------------------------------------------------------------------------------------------------------------------
# Name                     Status     SRC-IP           DST-IP           GRE    DSCP   TTL    Queue    Policer    SRC-Port         Direction
# -----------------------------------------------------------------------------------------------------------------------------------------
# dell-2                   inactive   32.22.22.22      31.11.11.11      0x6689 6      9      0                   Ethernet28       rx
# dell-3                   inactive   21.21.21.12      22.22.22.12                                               Ethernet28       rx
# SPAN Sessions
# -------------------------------------------------------------------------------
# Name                     Status     DST-Port         SRC-Port         Direction
# -------------------------------------------------------------------------------
# dell-1                   active     Ethertnet4       Ethernet24       tx


# Using "overridden" state
#
# Before state:
# -------------
#
# sonic# show mirror-session
# ERSPAN Sessions
# -----------------------------------------------------------------------------------------------------------------------------------------
# Name                     Status     SRC-IP           DST-IP           GRE    DSCP   TTL    Queue    Policer    SRC-Port         Direction
# -----------------------------------------------------------------------------------------------------------------------------------------
# dell-2                   inactive   200.22.22.22     100.11.11.11                          0                   Ethernet28       both
# SPAN Sessions
# -------------------------------------------------------------------------------
# Name                     Status     DST-Port         SRC-Port         Direction
# -------------------------------------------------------------------------------
# dell-1                   active     CPU              Ethernet24       both
# dell-3                   active     CPU

- name: Override mirroring configuration
  dellemc.enterprise_sonic.sonic_mirroring:
    config:
      erspan:
        - name: dell-2
          dst_ip: 32.22.22.12
          src_ip: 31.21.21.12
          source: Ethernet28
          gre: "0x6689"
          dscp: 6
          ttl: 9
          queue: 0
          direction: rx
        - name: dell-1
          dst_ip: 22.22.22.12
          src_ip: 21.21.21.12
          source: Ethernet28
          direction: rx
      span:
        - name: dell-6
          dst_port: CPU
          source: Ethernet24
          direction: tx
    state: overridden

# After state:
# ------------
#
# sonic# show mirror-session
# ERSPAN Sessions
# -----------------------------------------------------------------------------------------------------------------------------------------
# Name                     Status     SRC-IP           DST-IP           GRE    DSCP   TTL    Queue    Policer    SRC-Port         Direction
# -----------------------------------------------------------------------------------------------------------------------------------------
# dell-1                   inactive   21.21.21.12      22.22.22.12                                               Ethernet28       rx
# dell-2                   inactive   31.21.21.12      32.22.22.12      0x6689 6      9      0                   Ethernet28       rx
# SPAN Sessions
# -------------------------------------------------------------------------------
# Name                     Status     DST-Port         SRC-Port         Direction
# -------------------------------------------------------------------------------
# dell-6                   active     Ethertnet4       Ethernet24       tx

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

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

Ключ	Описание
after dictionary	Конфигурация, полученная в результате вызова модуля. Возвращается: при изменении
after(generated) dictionary	Конфигурация, которая была бы получена при вызове модуля не в режиме проверки. Возвращается: когда `check_mode`
before dictionary	Конфигурация до вызова модуля. Возвращается: всегда
commands list / elements=string	Набор команд, отправленных на удаленное устройство. В `check_mode` необходимые команды отображаются, но не отправляются на устройство. Возвращается: всегда Пример: `["command 1", "command 2", "command 3"]`

Авторы

1. Zhang (@mingjunzhang2019)

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

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