Spec-Zone.ru › Ansible

Модуль dellemc.enterprise_sonic.sonic_fbs_classifiers — управление конфигурацией классификаторов служб на основе потоков (FBS) в 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_fbs_classifiers.

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

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

Обзор

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

Параметры

Параметр

Комментарии

config

list / elements=dictionary

Конфигурация классификаторов FBS

match_acl и match_hdr_fields являются взаимоисключающими.

class_description

string

Описание классификатора

class_name

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

Имя классификатора

match_acl

dictionary

Конфигурация сопоставления ACL

acl_name

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

Имя ACL, используемого в качестве критерия сопоставления

acl_type

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

Тип ACL, используемого в качестве критерия сопоставления

Варианты:

  • "ip"
  • "ipv6"
  • "mac"

match_hdr_fields

dictionary

Конфигурация сопоставления полей заголовка

ipv4 и ipv6 являются взаимоисключающими.

ip

dictionary

Конфигурация полей IP

dscp

integer

Значение кода DSCP (DiffServ), диапазон 0–63

protocol

string

Протокол IP

Варианты:

  • "auth"
  • "gre"
  • "icmp"
  • "icmpv6"
  • "igmp"
  • "l2tp"
  • "pim"
  • "rsvp"
  • "tcp"
  • "udp"

ipv4

dictionary

Конфигурация полей IPv4

destination_address

string

Префикс адреса назначения IPv4

source_address

string

Префикс исходного адреса IPv4

ipv6

dictionary

Конфигурация полей IPv6

destination_address

string

Префикс адреса назначения IPv6

source_address

string

Префикс исходного адреса IPv6

l2

dictionary

Конфигурация полей Ethernet

dei

integer

Индикатор возможности отбрасывания, диапазон 0–1

destination_mac

string

MAC-адрес назначения

destination_mac_mask

string

Маска MAC-адреса назначения

ethertype

string

Поле EtherType для сопоставления в пакетах Ethernet

Варианты:

  • "arp"
  • "ipv4"
  • "ipv6"
  • "lldp"
  • "mpls"
  • "roce"
  • "vlan"

pcp

integer

Код точки приоритета, диапазон 0–7

source_mac

string

Исходный MAC-адрес

source_mac_mask

string

Маска исходного MAC-адреса

vlanid

integer

Идентификатор VLAN, диапазон 1–4094

transport

dictionary

Конфигурация транспортных полей

destination_port

string

Порт назначения или диапазон портов

Чтобы указать диапазон, используйте разделитель «..», например «1..3».

icmp_code

integer

Код ICMP или ICMPv6, диапазон 0–255

icmp_type

integer

Тип ICMP или ICMPv6, диапазон 0–255

source_port

string

Исходный порт или диапазон портов

Чтобы указать диапазон, используйте разделитель «..», например «1..3».

tcp_flags

list / elements=string

Список флагов TCP для сопоставления

Варианты:

  • "ack"
  • "fin"
  • "psh"
  • "rst"
  • "syn"
  • "urg"

match_type

string

Тип сопоставления классификатора

Тип сопоставления классификатора требуется для его создания и соответствует конфигурации «match_acl» или «match_hdr_fields».

Варианты:

  • "acl"
  • "fields"

state

string

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

Варианты:

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

Примечания

Примечание

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

Примеры

# Using "merged" state
#
# Before state:
# -------------
#
# sonic# show class-map
# (No 'class-map' configuration present)

- name: Merge FBS classifiers configuration
  dellemc.enterprise_sonic.sonic_fbs_classifiers:
    config:
      - class_name: class1
        class_description: xyz
        match_type: fields
        match_hdr_fields:
          ip:
            dscp: 0
            protocol: tcp
          ipv4:
            source_address: 1.1.1.1/1
            destination_address: 2.2.2.2/2
          l2:
            source_mac: 1a:2b:3c:4d:5e:6f
            source_mac_mask: 6a:5b:4c:3d:2e:1f
            destination_mac: 2a:4b:6c:8d:10:20
            destination_mac_mask: 20:10:8d:6c:4b:2a
            dei: 0
            ethertype: ipv4
            pcp: 0
            vlanid: 1
          transport:
            source_port: 1..3
            destination_port: 4..6
            tcp_flags:
              - ack
              - fin
              - psh
    state: merged

# After state:
# ------------
#
# sonic# show class-map
# Class-map class1 match-type fields
#   Description: xyz
#   Match:
#     ethertype ip
#     src-mac 1a:2b:3c:4d:5e:6f/6a:5b:4c:3d:2e:1f
#     dst-mac 2a:4b:6c:8d:10:20/20:10:8d:6c:4b:2a
#     vlan 1
#     pcp be
#     dei 0
#     ip protocol tcp
#     src-ip 1.1.1.1/1
#     dst-ip 2.2.2.2/2
#     dscp default
#     src-port 1-3
#     dst-port 4-6
#     tcp-flags fin psh ack
#   Referenced in flows:


# Using "replaced" state
#
# Before state:
# -------------
#
# sonic# show class-map
# Class-map class1 match-type fields
#   Description: xyz
#   Match:
#     ethertype ip
#     src-mac 1a:2b:3c:4d:5e:6f/6a:5b:4c:3d:2e:1f
#     dst-mac 2a:4b:6c:8d:10:20/20:10:8d:6c:4b:2a
#     vlan 1
#     pcp be
#     dei 0
#     ip protocol tcp
#     src-ip 1.1.1.1/1
#     dst-ip 2.2.2.2/2
#     dscp default
#     src-port 1-3
#     dst-port 4-6
#     tcp-flags fin psh ack
#   Referenced in flows:
#
# Class-map class2 match-type acl
#   Description: abc
#   Match:
#     ip access-group acl1
#   Referenced in flows:

- name: Replace FBS classifiers configuration
  dellemc.enterprise_sonic.sonic_fbs_classifiers:
    config:
      - class_name: class1
        match_hdr_fields:
          l2:
            source_mac: 9a:8b:7c:6d:5e:4f
            source_mac_mask: 2a:4b:1c:9b:1e:0f
            destination_mac: 1a:6c:3c:4f:40:22
            destination_mac_mask: 26:44:8c:9d:4b:6f
            ethertype: vlan
            pcp: 6
            vlanid: 2
    state: replaced

# After state:
# ------------
#
# sonic# show class-map
# Class-map class1 match-type fields
#   Description: xyz
#   Match:
#     ethertype 0x8100
#     src-mac 9a:8b:7c:6d:5e:4f/2a:4b:1c:9b:1e:0f
#     dst-mac 1a:6c:3c:4f:40:22/26:44:8c:9d:4b:6f
#     vlan 2
#     pcp ic
#   Referenced in flows:
#
# Class-map class2 match-type acl
#   Description: abc
#   Match:
#     ip access-group acl1
#   Referenced in flows:


# Using "overridden" state
#
# Before state:
# -------------
#
# sonic# show class-map
# Class-map class1 match-type fields
#   Description: xyz
#   Match:
#     ethertype 0x8100
#     src-mac 9a:8b:7c:6d:5e:4f/2a:4b:1c:9b:1e:0f
#     dst-mac 1a:6c:3c:4f:40:22/26:44:8c:9d:4b:6f
#     vlan 2
#     pcp ic
#   Referenced in flows:

- name: Override FBS classifiers configuration
  dellemc.enterprise_sonic.sonic_fbs_classifiers:
    config:
      - class_name: class2
        class_description: abc
        match_type: acl
        match_acl:
          acl_name: acl1
          acl_type: ip

# After state:
# ------------
#
# sonic# show class-map
# Class-map class2 match-type acl
#   Description: abc
#   Match:
#     ip access-group acl1
#   Referenced in flows:


# Using "deleted" state
#
# Before state:
# -------------
#
# sonic# show class-map
# Class-map class1 match-type fields
#   Description: xyz
#   Match:
#     ethertype 0x8100
#     src-mac 9a:8b:7c:6d:5e:4f/2a:4b:1c:9b:1e:0f
#     dst-mac 1a:6c:3c:4f:40:22/26:44:8c:9d:4b:6f
#     vlan 2
#     pcp ic
#   Referenced in flows:
#
# Class-map class2 match-type acl
#   Description: abc
#   Match:
#     ip access-group acl1
#   Referenced in flows:

- name: Delete FBS classifiers configuration
  dellemc.enterprise_sonic.sonic_fbs_classifiers:
    config:
      - class_name: class1
        class_description: xyz
        match_hdr_fields:
          l2:
            source_mac: 9a:8b:7c:6d:5e:4f
            source_mac_mask: 2a:4b:1c:9b:1e:0f
            destination_mac: 1a:6c:3c:4f:40:22
            destination_mac_mask: 26:44:8c:9d:4b:6f
            ethertype: vlan
            pcp: 6
            vlanid: 2
      - class_name: class2
    state: deleted

# After state:
# ------------
#
# sonic# show class-map
# Class-map class1 match-type fields
#   Description:
#   Match:
#   Referenced in flows:


# Using "deleted" state
#
# Before state:
# -------------
#
# sonic# show class-map
# Class-map class1 match-type fields
#   Description: xyz
#   Match:
#     ethertype 0x8100
#     src-mac 9a:8b:7c:6d:5e:4f/2a:4b:1c:9b:1e:0f
#     dst-mac 1a:6c:3c:4f:40:22/26:44:8c:9d:4b:6f
#     vlan 2
#     pcp ic
#   Referenced in flows:
#
# Class-map class2 match-type acl
#   Description: abc
#   Match:
#     ip access-group acl1
#   Referenced in flows:

- name: Delete all FBS classifiers configuration
  dellemc.enterprise_sonic.sonic_fbs_classifiers:
    config:
    state: deleted

# After state:
# ------------
#
# sonic# show class-map
# (No 'class-map' configuration present)

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

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

Ключ

Описание

after

list / elements=string

Конфигурация, полученная в результате выполнения модуля.

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

after(generated)

list / elements=string

Конфигурация, сформированная при выполнении модуля.

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

before

list / elements=string

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

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

commands

list / elements=string

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

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

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

Авторы

    1. 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_fbs_classifiers_module.html

Spec-Zone.ru

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