Spec-Zone.ru › Ansible

dellemc.enterprise_sonic.sonic_mac module – Управление конфигурацией MAC на 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_mac.

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

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

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

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

Параметры

Параметр

Комментарии

config

list / elements=dictionary

Список конфигураций MAC.

mac

dictionary

Атрибуты конфигурации MAC.

aging_time

integer

Время в секундах бездействия, по истечении которого запись MAC становится недействительной.

По умолчанию: 600

dampening_interval

integer

Интервал наблюдения за перемещениями MAC-адресов перед отключением обучения MAC на порту.

По умолчанию: 5

dampening_threshold

integer

Количество перемещений MAC-адресов в секунду, допустимое до отключения обучения MAC на порту.

По умолчанию: 5

mac_table_entries

list / elements=dictionary

Атрибуты конфигурации записей таблицы MAC.

interface

string

Задает интерфейс для записи таблицы MAC.

mac_address

string / обязательный

MAC-адрес для динамической или статической записи таблицы MAC.

vlan_id

integer / обязательный

Идентификатор VLAN, в которой присутствует MAC-адрес.

vrf_name

string

Задает имя VRF.

По умолчанию: "default"

state

string

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

Варианты:

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

Примечания

Примечание

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

Примеры

# Using "merged" state
#
# Before state:
# -------------
#
# sonic# show mac dampening
# MAC Move Dampening Threshold : 5
# MAC Move Dampening Interval  : 5
# sonic# show running-configuration | grep mac
# (No mac configuration pressent)

- name: Merge MAC configurations
  dellemc.enterprise_sonic.sonic_mac:
  config:
    - vrf_name: 'default'
      mac:
        aging_time: 50
        dampening_interval: 20
        dampening_threshold: 30
        mac_table_entries:
          - mac_address: '00:00:5e:00:53:af'
            vlan_id: 1
            interface: 'Ethernet20'
          - mac_address: '00:33:33:33:33:33'
            vlan_id: 2
            interface: 'Ethernet24'
          - mac_address: '00:00:4e:00:24:af'
            vlan_id: 3
            interface: 'Ethernet28'
  state: merged

# After state:
# ------------
#
# sonic# show mac dampening
# MAC Move Dampening Threshold : 30
# MAC Move Dampening Interval  : 20
# sonic# show running-configuration | grep mac
# mac address-table 00:00:5e:00:53:af Vlan1 Ethernet20
# mac address-table 00:33:33:33:33:33 Vlan2 Ethernet24
# mac address-table 00:00:4e:00:24:af Vlan3 Ethernet28
# mac address-table aging-time 50
#
#
# Using "replaced" state
#
# Before state:
# -------------
#
# sonic# show mac dampening
# MAC Move Dampening Threshold : 30
# MAC Move Dampening Interval  : 20
# sonic# show running-configuration | grep mac
# mac address-table 00:00:5e:00:53:af Vlan1 Ethernet20
# mac address-table 00:33:33:33:33:33 Vlan2 Ethernet24
# mac address-table 00:00:4e:00:24:af Vlan3 Ethernet28
# mac address-table aging-time 50

- name: Replace MAC configurations
  dellemc.enterprise_sonic.sonic_mac:
  config:
    - vrf_name: 'default'
      mac:
        aging_time: 45
        dampening_interval: 30
        dampening_threshold: 60
        mac_table_entries:
          - mac_address: '00:00:5e:00:53:af'
            vlan_id: 3
            interface: 'Ethernet24'
          - mac_address: '00:44:44:44:44:44'
            vlan_id: 2
            interface: 'Ethernet20'
  state: replaced

# sonic# show mac dampening
# MAC Move Dampening Threshold : 60
# MAC Move Dampening Interval  : 30
# sonic# show running-configuration | grep mac
# mac address-table 00:00:5e:00:53:af Vlan3 Ethernet24
# mac address-table 00:33:33:33:33:33 Vlan2 Ethernet24
# mac address-table 00:00:4e:00:24:af Vlan3 Ethernet28
# mac address-table 00:44:44:44:44:44 Vlan2 Ethernet20
# mac address-table aging-time 45
#
#
# Using "overridden" state
#
# Before state:
# -------------
#
# sonic# show mac dampening
# MAC Move Dampening Threshold : 60
# MAC Move Dampening Interval  : 30
# sonic# show running-configuration | grep mac
# mac address-table 00:00:5e:00:53:af Vlan3 Ethernet24
# mac address-table 00:33:33:33:33:33 Vlan2 Ethernet24
# mac address-table 00:00:4e:00:24:af Vlan3 Ethernet28
# mac address-table 00:44:44:44:44:44 Vlan2 Ethernet20
# mac address-table aging-time 45

- name: Override MAC cofigurations
  dellemc.enterprise_sonic.sonic_mac:
  config:
    - vrf_name: 'default'
      mac:
        aging_time: 10
        dampening_interval: 20
        dampening_threshold: 30
        mac_table_entries:
          - mac_address: '00:11:11:11:11:11'
            vlan_id: 1
            interface: 'Ethernet20'
          - mac_address: '00:22:22:22:22:22'
            vlan_id: 2
            interface: 'Ethernet24'
  state: overridden

# After state:
# ------------
#
# sonic# show mac dampening
# MAC Move Dampening Threshold : 30
# MAC Move Dampening Interval  : 20
# sonic# show running-configuration | grep mac
# mac address-table 00:11:11:11:11:11 Vlan1 Ethernet20
# mac address-table 00:22:22:22:22:22 Vlan2 Ethernet24
# mac address-table aging-time 10
#
#
# Using "deleted" state
#
# Before state:
# -------------
#
# sonic# show mac dampening
# MAC Move Dampening Threshold : 30
# MAC Move Dampening Interval  : 20
# sonic# show running-configuration | grep mac
# mac address-table 00:11:11:11:11:11 Vlan1 Ethernet20
# mac address-table 00:22:22:22:22:22 Vlan2 Ethernet24
# mac address-table aging-time 10

- name: Delete MAC cofigurations
  dellemc.enterprise_sonic.sonic_mac:
  config:
    - vrf_name: 'default'
      mac:
        aging_time: 10
        dampening_interval: 20
        dampening_threshold: 30
        mac_table_entries:
          - mac_address: '00:11:11:11:11:11'
            vlan_id: 1
            interface: 'Ethernet20'
          - mac_address: '00:22:22:22:22:22'
            vlan_id: 2
            interface: 'Ethernet24'
  state: deleted

# After state:
# ------------
#
# sonic# show mac dampening
# MAC Move Dampening Threshold : 5
# MAC Move Dampening Interval  : 5
# sonic# show running-configuration | grep mac
# (No mac configuration present)

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

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

Ключ

Описание

after

list / elements=string

Итоговый вызов модуля конфигурации.

Возвращается: при изменении

Пример: ["The configuration returned will always be in the same format as the parameters above.\n"]

after(generated)

list / elements=string

Сгенерированный вызов модуля конфигурации.

Возвращается: при check_mode

Пример: ["The configuration returned will always be in the same format as the parameters above.\n"]

before

list / elements=string

Конфигурация до вызова модуля.

Возвращается: всегда

Пример: ["The configuration returned will always be in the same format as the parameters above.\n"]

commands

list / elements=string

Набор команд, отправленных на удаленное устройство.

Возвращается: всегда

Пример: ["command 1", "command 2", "command 3"]

Авторы

    1. S. 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_mac_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API