Модуль dellemc.enterprise_sonic.sonic_ecmp_load_share — управление конфигурацией режима распределения нагрузки IP ECMP для 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_ecmp_load_share.
Добавлено в dellemc.enterprise_sonic 3.1.0
Краткое описание
- Этот модуль обеспечивает управление конфигурацией режима распределения нагрузки IP ECMP на
- устройствах под управлением SONiC.
Параметры
Параметр | Комментарии |
|---|---|
config dictionary | Конфигурация режима распределения нагрузки IP ECMP. |
|
hash_algorithm string |
Алгоритм хеширования для распределения нагрузки. Варианты:
|
|
hash_ingress_port boolean |
Включать входящий порт в вычисление хеша распределения нагрузки. Варианты:
|
|
hash_offset dictionary |
Смещение хеша распределения нагрузки. |
|
flow_based boolean |
Включить хеширование IP ECMP на основе потоков. Если этому параметру задано значение true, настроенное значение «offset» игнорируется. Варианты:
|
|
offset integer |
Значение смещения хеша IP ECMP. Допустимый диапазон значений: от 0 до 15. |
|
hash_roce_qpn boolean |
Включать номер пары очередей ROCE в вычисление хеша распределения нагрузки. Варианты:
|
|
hash_seed integer |
Значение начального числа хеша IP ECMP. Допустимый диапазон значений: от 0 до 16777215. |
|
ipv4 dictionary |
Параметры хеширования распределения нагрузки IPv4 ECMP. |
|
ipv4_dst_ip boolean |
Включать IP-адрес назначения IPv4 в вычисление хеша распределения нагрузки. Варианты:
|
|
ipv4_ip_proto boolean |
Включать значение протокола IPv4 в вычисление хеша распределения нагрузки. Варианты:
|
|
ipv4_l4_dst_port boolean |
Включать порт источника IPv4 L4 в вычисление хеша распределения нагрузки. Варианты:
|
|
ipv4_l4_src_port boolean |
Порт источника IPv4 L4. Варианты:
|
|
ipv4_src_ip boolean |
Включать IP-адрес источника IPv4 в вычисление хеша распределения нагрузки. Варианты:
|
|
ipv4_symmetric boolean |
Режим симметричного хеширования IPv4. Варианты:
|
|
ipv6 dictionary |
Параметры хеширования распределения нагрузки IPv6 ECMP. |
|
ipv6_dst_ip boolean |
Включать IP-адрес назначения IPv6 в вычисление хеша распределения нагрузки. Варианты:
|
|
ipv6_l4_dst_port boolean |
Включать порт назначения IPv6 L4 в вычисление хеша распределения нагрузки. Варианты:
|
|
ipv6_l4_src_port boolean |
Включать порт источника IPv6 L4 в вычисление хеша распределения нагрузки. Варианты:
|
|
ipv6_next_hdr boolean |
Включать значение «следующий заголовок» IPv6 (обычно тип протокола транспортного уровня) в вычисление хеша распределения нагрузки. Варианты:
|
|
ipv6_src_ip boolean |
Включать IP-адрес источника IPv6 в вычисление хеша распределения нагрузки. Варианты:
|
|
ipv6_symmetric boolean |
Режим симметричного хеширования IPv6. Варианты:
|
state string | Состояние конфигурации после выполнения модуля. Варианты:
|
Примечания
Примечание
- Проверено на Enterprise SONiC Distribution от Dell Technologies.
- Поддерживает
check_mode.
Примеры
# Using "deleted" state
#
# Before state:
# -------------
#
# sonic# show running-configuration | grep load-share
# ip load-share hash offset flow-based
# ip load-share hash seed 8888
# ip load-share hash ipv4 ipv4-dst-ip
# ip load-share hash ipv4 ipv4-src-ip
# ip load-share hash ipv4 ipv4-ip-proto
# ip load-share hash ipv4 ipv4-l4-src-port
# ip load-share hash ipv4 ipv4-l4-dst-port
# ip load-share hash algorithm CRC
# ip load-share hash ingress-port
# ip load-share hash roce qpn
- name: Delete some configuration
sonic_ecmp_load_share:
config:
hash_algorithm: CRC
hash_offset:
flow_based: true
hash_roce_qpn: true
hash_seed: 8888
ipv4:
ipv4_l4_dst_port: true
ipv4_l4_src_port: true
state: deleted
# After state:
# ------------
#
# sonic# show running-configuration | grep load-share
# ip load-share hash ipv4 ipv4-dst-ip
# ip load-share hash ipv4 ipv4-src-ip
# ip load-share hash ipv4 ipv4-ip-proto
# ip load-share hash ingress-port
# Using "merged" state
#
# Before state:
# -------------
#
# sonic# show running-configuration | grep load-share
# ip load-share hash seed 8888
# ip load-share hash ipv4 ipv4-dst-ip
# ip load-share hash algorithm CRC
- name: Merge some configuration
sonic_ecmp_load_share:
config:
hash_algorithm: CRC_32LO
hash_ingress_port: true
hash_offset:
offset: 12
flow_based: true
hash_roce_qpn: true
hash_seed: 9999
ipv4:
ipv4_src_ip: true
ipv4_ip_proto: true
ipv4_l4_dst_port: true
ipv4_l4_src_port: true
state: merged
# After state:
# ------------
#
# sonic# show running-configuration | grep load-share
# ip load-share hash seed 9999
# ip load-share hash ipv4 ipv4-dst-ip
# ip load-share hash ipv4 ipv4-src-ip
# ip load-share hash ipv4 ipv4-ip-proto
# ip load-share hash ipv4 ipv4-l4-src-port
# ip load-share hash ipv4 ipv4-l4-dst-port
# ip load-share hash algorithm CRC_32LO
# ip load-share hash ingress-port
# Using "replaced" state
#
# Before state:
# -------------
#
# sonic# show running-configuration | grep load-share
# ip load-share hash offset flow-based
# ip load-share hash seed 8888
# ip load-share hash ipv4 ipv4-dst-ip
# ip load-share hash ipv4 ipv4-src-ip
# ip load-share hash algorithm CRC
# ip load-share hash ingress-port
- name: Replace some configuration
sonic_ecmp_load_share:
config:
hash_algorithm: XOR
hash_ingress_port: true
hash_offset:
flow_based: true
hash_seed: 7777
ipv4:
ipv4_src_ip: true
state: replaced
# After state:
# ------------
#
# sonic# show running-configuration | grep load-share
# ip load-share hash offset flow-based
# ip load-share hash seed 7777
# ip load-share hash ipv4 ipv4-src-ip
# ip load-share hash algorithm XOR
# ip load-share hash ingress-port
# Using overridden
#
# Before state:
# -------------
#
# sonic# show running-configuration | grep load-share
# ip load-share hash offset flow-based
# ip load-share hash seed 9999
# ip load-share hash ipv4 ipv4-src-ip
# ip load-share hash ipv4 ipv4-ip-proto
# ip load-share hash ipv4 ipv4-l4-src-port
# ip load-share hash ipv4 ipv4-l4-dst-port
# ip load-share hash algorithm XOR
# ip load-share hash ingress-port
- name: Override some configuration
sonic_ecmp_load_share:
config:
hash_algorithm: CRC_32LO
hash_ingress_port: true
hash_offset:
flow_based: true
hash_seed: 1234
ipv4:
ipv4_l4_dst_port: true
ipv4_l4_src_port: true
state: overridden
# After state:
# ------------
#
# sonic# show running-configuration | grep load-share
# ip load-share hash offset flow-based
# ip load-share hash seed 1234
# ip load-share hash ipv4 ipv4-l4-src-port
# ip load-share hash ipv4 ipv4-l4-dst-port
# ip load-share hash algorithm CRC_32LO
# ip load-share hash ingress-port
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
after dictionary | Конфигурация, полученная в результате вызова модуля. Возвращается: при изменении |
after(generated) dictionary | Конфигурация, которая была бы получена при вызове модуля вне режима проверки. Возвращается: когда |
before dictionary | Конфигурация до вызова модуля. Возвращается: всегда |
commands list / elements=string | Набор команд, отправленных на удалённое устройство. В режиме Возвращается: всегда Пример: |
Авторы
-
- 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_ecmp_load_share_module.html