Модуль dellemc.enterprise_sonic.sonic_lag_interfaces — управление параметрами интерфейсов группы агрегации каналов (LAG)
Примечание
Этот модуль входит в коллекцию dellemc.enterprise_sonic (версия 3.2.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install dellemc.enterprise_sonic.
Чтобы использовать её в плейбуке, укажите: dellemc.enterprise_sonic.sonic_lag_interfaces.
Добавлено в dellemc.enterprise_sonic 1.0.0
Обзор
- Этот модуль управляет атрибутами интерфейсов группы агрегации каналов (LAG) устройств под управлением Enterprise SONiC Distribution от Dell Technologies.
Параметры
Параметр | Комментарии |
|---|---|
config list / elements=dictionary | Список конфигураций LAG. |
|
ethernet_segment dictionary добавлено в dellemc.enterprise_sonic 2.5.0 |
Задаёт сегмент Ethernet. esi_type и esi нельзя удалить отдельно. Если задано state=deleted, а esi и df_preference не указаны, весь сегмент Ethernet будет удалён. |
|
df_preference integer |
Приоритет метода выбора назначенного пересылателя (Designated Forwarder). Значение df_preference должно находиться в диапазоне от 1 до 65535. |
|
esi string |
Задаёт значение идентификатора сегмента Ethernet. При esi_type=auto_lacp или esi_type=auto_system_mac поддерживается только |
|
esi_type string / обязательный |
Задаёт тип идентификатора сегмента Ethernet. Варианты:
|
|
fallback boolean добавлено в dellemc.enterprise_sonic 3.1.0 |
Включает режим резервного переключения. Варианты:
|
|
fast_rate boolean добавлено в dellemc.enterprise_sonic 3.1.0 |
Включает режим высокой частоты LACP. Варианты:
|
|
graceful_shutdown boolean добавлено в dellemc.enterprise_sonic 3.1.0 |
Включает корректное завершение работы. Варианты:
|
|
lacp_individual dictionary добавлено в dellemc.enterprise_sonic 3.1.0 |
Задаёт индивидуальную конфигурацию LACP. Применимо только при mode=lacp. |
|
enable boolean |
Включает индивидуальный режим LACP. Варианты:
|
|
timeout integer |
Задаёт тайм-аут индивидуального режима LACP в секундах. Диапазон значений: от 3 до 90. |
|
members dictionary |
Список интерфейсов, входящих в группу. |
|
interfaces list / elements=dictionary |
Список интерфейсов, входящих в группу. |
|
member string |
Имя интерфейса. |
|
min_links integer добавлено в dellemc.enterprise_sonic 3.1.0 |
Задаёт минимальное количество каналов. Диапазон значений: от 1 до 32. |
|
mode string |
Задаёт режим port-channel при создании. Функциональное значение по умолчанию — Варианты:
|
|
name string / обязательный |
Идентификатор LAG. |
|
system_mac string добавлено в dellemc.enterprise_sonic 3.1.0 |
Задаёт MAC-адрес системы для port-channel. |
state string | Состояние, в котором должна остаться конфигурация. Варианты:
|
Примечания
Примечание
- Проверено на Enterprise SONiC Distribution от Dell Technologies.
- Поддерживает
check_mode.
Примеры
# Using "merged" state
#
# Before state:
# -------------
#
# interface Eth1/10
# mtu 9100
# speed 100000
# no shutdown
# !
# interface PortChannel10
# no shutdown
#
- name: Merge LAG interfaces configuration
dellemc.enterprise_sonic.sonic_lag_interfaces:
config:
- name: PortChannel10
fallback: true
fast_rate: true
graceful_shutdown: true
members:
interfaces:
- member: Eth1/10
system_mac: "12:12:12:12:12:12"
ethernet_segment:
esi_type: auto_lacp
df_preference: 2222
- name: PortChannel12
min_links: 2
members:
interfaces:
- member: Eth1/15
- member: Eth1/16
- member: Eth1/17
lacp_individual:
enable: true
timeout: 30
state: merged
# After state:
# ------------
#
# interface Eth1/10
# channel-group 10
# mtu 9100
# speed 100000
# no shutdown
# !
# interface Eth1/15
# channel-group 12
# mtu 9100
# speed 100000
# no shutdown
# !
# interface Eth1/16
# channel-group 12
# mtu 9100
# speed 100000
# no shutdown
# !
# interface Eth1/17
# channel-group 12
# mtu 9100
# speed 100000
# no shutdown
# !
# interface PortChannel10
# fast_rate
# fallback
# graceful-shutdown
# no shutdown
# system-mac 12:12:12:12:12:12
# !
# evpn ethernet-segment auto-lacp
# df-preference 2222
# !
# !
# interface PortChannel12
# min-links 2
# lacp individual
# lacp individual timeout 30
# no shutdown
#
# Using "replaced" state
#
# Before state:
# -------------
#
# interface Eth1/5
# channel-group 10
# mtu 9100
# speed 100000
# no shutdown
# !
# interface Eth1/7
# no channel-group
# mtu 9100
# speed 100000
# no shutdown
# !
# interface PortChannel10
# graceful-shutdown
# no shutdown
# system-mac 12:12:12:12:12:12
# !
# evpn ethernet-segment auto-lacp
# df-preference 2222
#
- name: Replace LAG configurations of specified LAG interfaces
dellemc.enterprise_sonic.sonic_lag_interfaces:
config:
- name: PortChannel20
members:
interfaces:
- member: Eth1/6
system_mac: "14:14:14:14:14:14"
ethernet_segment:
esi_type: auto_system_mac
df_preference: 6666
- name: PortChannel10
members:
interfaces:
- member: Eth1/7
system_mac: "14:14:14:14:14:14"
ethernet_segment:
esi_type: auto_system_mac
df_preference: 3333
state: replaced
# After state:
# ------------
#
# interface Eth1/5
# mtu 9100
# speed 100000
# no shutdown
# !
# interface Eth1/6
# channel-group 20
# mtu 9100
# speed 100000
# no shutdown
# !
# interface Eth1/7
# channel-group 10
# mtu 9100
# speed 100000
# no shutdown
# !
# interface PortChannel10
# no shutdown
# system-mac 14:14:14:14:14:14
# !
# evpn ethernet-segment auto-system-mac
# df-preference 3333
# !
# interface PortChanne20
# no shutdown
# system-mac 14:14:14:14:14:14
# !
# evpn ethernet-segment auto-system-mac
# df-preference 6666
#
# Using "overridden" state
#
# Before state:
# -------------
#
# interface Eth1/5
# channel-group 10
# mtu 9100
# speed 100000
# no shutdown
# !
# interface Eth1/6
# no channel-group
# mtu 9100
# speed 100000
# no shutdown
# !
# interface PortChannel10
# fast_rate
# fallback
# no shutdown
# !
# evpn ethernet-segment auto-system-mac
# df-preference 2222
#
- name: Override all LAG interface configurations
dellemc.enterprise_sonic.sonic_lag_interfaces:
config:
- name: PortChannel20
min_links: 2
members:
interfaces:
- member: Eth1/6
- member: Eth1/7
- member: Eth1/8
system_mac: "12:12:12:12:12:12"
ethernet_segment:
esi_type: auto_lacp
df_preference: 3333
lacp_individual:
enable: true
timeout: 60
state: overridden
# After state:
# ------------
#
# interface Eth1/5
# mtu 9100
# speed 100000
# no shutdown
# !
# interface Eth1/6
# channel-group 20
# mtu 9100
# speed 100000
# no shutdown
# !
# interface Eth1/7
# channel-group 20
# mtu 9100
# speed 100000
# no shutdown
# !
# interface Eth1/8
# channel-group 20
# mtu 9100
# speed 100000
# no shutdown
# !
# interface PortChannel20
# min-links 2
# lacp individual
# lacp individual timeout 60
# no shutdown
# system-mac 12:12:12:12:12:12
# !
# evpn ethernet-segment auto-lacp
# df-preference 3333
#
# Using "deleted" state
#
# Before state:
# -------------
#
# interface Eth1/10
# channel-group 10
# mtu 9100
# speed 100000
# no shutdown
# !
# interface Eth1/15
# channel-group 12
# mtu 9100
# speed 100000
# no shutdown
# !
# interface Eth1/16
# channel-group 12
# mtu 9100
# speed 100000
# no shutdown
# !
# interface PortChannel 10
# no shutdown
# system-mac 12:12:12:12:12:12
# !
# evpn ethernet-segment auto-lacp
# df-preference 2222
# !
# interface PortChannel 12
# fast_rate
# fallback
# graceful-shutdown
# min-links 2
# no shutdown
#
- name: Delete all LAG interfaces
dellemc.enterprise_sonic.sonic_lag_interfaces:
config:
state: deleted
# After state:
# -------------
#
# interface Eth1/10
# mtu 9100
# speed 100000
# no shutdown
# !
# interface Eth1/15
# mtu 9100
# speed 100000
# no shutdown
# !
# interface Eth1/16
# mtu 9100
# speed 100000
# no shutdown
#
# Using "deleted" state
#
# Before state:
# -------------
# interface Eth1/10
# channel-group 10
# mtu 9100
# speed 100000
# no shutdown
# !
# interface Eth1/11
# channel-group 10
# mtu 9100
# speed 100000
# no shutdown
# !
# interface Eth1/20
# channel-group 20
# mtu 9100
# speed 100000
# no shutdown
# !
# interface PortChannel10
# min-links 2
# no shutdown
# system-mac 12:12:12:12:12:12
# !
# evpn ethernet-segment auto-lacp
# df-preference 2222
# !
# interface PortChannel20
# no shutdown
#
- name: Delete specified LAG configurations and LAG interfaces
dellemc.enterprise_sonic.sonic_lag_interfaces:
config:
- name: PortChannel10
min_links: 2
members:
interfaces:
- member: Eth1/10
system_mac: "12:12:12:12:12:12"
ethernet_segment:
esi_type: auto_lacp
- name: PortChannel20
state: deleted
# After state:
# -------------
#
# interface Eth1/10
# mtu 9100
# speed 100000
# no shutdown
# !
# interface Eth1/11
# channel-group 10
# mtu 9100
# speed 100000
# no shutdown
# !
# interface Eth1/20
# mtu 9100
# speed 100000
# no shutdown
# !
# interface PortChannel10
# no shutdown
#
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
after list / elements=string | Итоговая конфигурация после вызова модуля. Возвращается: при наличии изменений Пример: |
after(generated) list / elements=string | Конфигурация, которая должна быть получена в результате вызова модуля. Возвращается: когда Пример: |
before list / elements=string | Конфигурация до вызова модуля. Возвращается: всегда Пример: |
commands list / elements=string | Набор команд, отправленных на удалённое устройство. Возвращается: всегда Пример: |
Ссылки на коллекцию
© 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_lag_interfaces_module.html
