Spec-Zone.ru › Ansible

модуль cisco.intersight.intersight_ethernet_adapter_policy — настройка политики адаптера Ethernet для Cisco Intersight

Примечание

Этот модуль входит в коллекцию cisco.intersight (версия 2.18.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в состав ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install cisco.intersight.

Чтобы использовать модуль в плейбуке, укажите: cisco.intersight.intersight_ethernet_adapter_policy.

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

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

  • Управляет настройкой политики адаптера Ethernet в Cisco Intersight.
  • Настраивает параметры виртуального интерфейса Ethernet, включая расширенные функции, такие как RDMA, QoS и возможности разгрузки.
  • Дополнительные сведения см. в документации Cisco Intersight.

Параметры

Параметр

Комментарии

advanced_filter

boolean

Включает расширенную фильтрацию на интерфейсе.

Варианты:

  • false ← (по умолчанию)
  • true

api_key_id

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

Идентификатор открытого API-ключа, связанного с закрытым ключом.

Если значение не задано, используется значение переменной среды INTERSIGHT_API_KEY_ID.

api_private_key

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

Имя файла (абсолютный путь) или строка с данными закрытого ключа в формате PEM, используемого для аутентификации в API Intersight.

Если используется строка, для шифрования ее данных следует использовать Ansible vault.

Например: ansible-vault encrypt_string --vault-id tme@/Users/dsoper/Documents/vault_password_file ‘-----BEGIN EC PRIVATE KEY-----

<your private key data>

-----END EC PRIVATE KEY-----’

Если значение не задано, используется значение переменной среды INTERSIGHT_API_PRIVATE_KEY.

api_uri

string

URI для доступа к API Intersight.

Если значение не задано, используется значение переменной среды INTERSIGHT_API_URI.

По умолчанию: "https://intersight.com/api/v1"

arfs_enabled

boolean

Состояние Accelerated Receive Flow Steering на виртуальном интерфейсе Ethernet.

Варианты:

  • false ← (по умолчанию)
  • true

completion_queue_count

integer

Количество ресурсов очередей завершения, которые необходимо выделить.

Как правило, количество выделяемых ресурсов очередей завершения равно сумме количества ресурсов очередей передачи и ресурсов очередей приема.

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

completion_ring_size

integer

Количество дескрипторов в каждой очереди завершения.

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

description

псевдонимы: descr

string

Описание политики адаптера Ethernet, заданное пользователем.

Описание может содержать буквы (a–z, A–Z), цифры (0–9), дефис (-), точку (.), двоеточие (:) или символ подчеркивания (_).

etherchannel_pinning_enabled

boolean

Включает закрепление каналов EtherChannel, позволяющее объединить несколько физических соединений между двумя коммутаторами в одно логическое соединение.

Для включения закрепления каналов EtherChannel необходимо задать количество очередей передачи не менее 2.

Варианты:

  • false ← (по умолчанию)
  • true

geneve_enabled

boolean

Протокол разгрузки GENEVE позволяет создавать логические сети, охватывающие границы физических сетей.

Нельзя включать одновременно с ARFS.

Варианты:

  • false ← (по умолчанию)
  • true

interrupt_coalescing_time

integer

Время ожидания между прерываниями или период простоя, который должен наступить до отправки прерывания.

Чтобы отключить объединение прерываний, введите в этом поле 0 (ноль).

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

interrupt_coalescing_type

string

Тип объединения прерываний.

MIN — система ожидает указанное в поле «Время объединения» время, прежде чем отправить следующее событие прерывания.

IDLE — система не отправляет прерывание, пока не наступит период бездействия длительностью не менее времени, указанного в поле «Время объединения».

Варианты:

  • "MIN" ← (по умолчанию)
  • "IDLE"

interrupt_count

integer

Количество ресурсов прерываний, которые необходимо выделить. Обычно оно равно количеству ресурсов очередей завершения.

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

interrupt_mode

string

Предпочтительный режим прерываний драйвера.

MSIx — прерывания с передачей сообщений (MSI) с дополнительным расширением (рекомендуется).

MSI — только MSI.

INTx — прерывания PCI INTx.

Варианты:

  • "MSIx" ← (по умолчанию)
  • "MSI"
  • "INTx"

interrupt_scaling

boolean

Включает масштабирование прерываний на интерфейсе.

Варианты:

  • false ← (по умолчанию)
  • true

name

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

Имя, назначенное политике адаптера Ethernet.

Имя должно содержать от 1 до 62 буквенно-цифровых символов; разрешены специальные символы :-_.

nvgre_enabled

boolean

Состояние виртуализации сети с использованием универсальной инкапсуляции маршрутизации (NVGRE) на виртуальном интерфейсе Ethernet.

Варианты:

  • false ← (по умолчанию)
  • true

organization

string

Имя организации, которой назначен этот ресурс.

Профили, политики и пулы, созданные в пользовательской организации, применяются только к устройствам в той же организации.

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

ptp_enabled

boolean

Состояние протокола точного времени (PTP) на виртуальном интерфейсе Ethernet.

PTP можно включить только на одном vNIC адаптера.

Варианты:

  • false ← (по умолчанию)
  • true

roce_class_of_service

integer

Класс обслуживания для RoCE на этом виртуальном интерфейсе.

Применяется только, если roce_enabled имеет значение true.

Варианты:

  • 1
  • 2
  • 4
  • 5 ← (по умолчанию)
  • 6

roce_enabled

boolean

При включении активирует RDMA over Converged Ethernet (RoCE) на этом виртуальном интерфейсе.

Нельзя включать одновременно с NVGRE.

Варианты:

  • false ← (по умолчанию)
  • true

roce_memory_regions

integer

Количество областей памяти на адаптер. Рекомендуемое значение — целая степень числа 2.

Применяется только, если roce_enabled имеет значение true.

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

roce_queue_pairs

integer

Количество пар очередей на адаптер. Рекомендуемое значение — целая степень числа 2.

Применяется только, если roce_enabled имеет значение true.

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

roce_resource_groups

integer

Количество групп ресурсов на адаптер. Рекомендуемое значение — целая степень числа 2, не меньшая количества ядер ЦП.

Применяется только, если roce_enabled имеет значение true.

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

roce_version

integer

Настройка версии RDMA over Converged Ethernet (RoCE) на виртуальном интерфейсе.

На адаптерах Cisco VIC серии 13xx поддерживается только RoCEv1, а на адаптерах Cisco VIC серии 14xx — только RoCEv2.

Применяется только, если roce_enabled имеет значение true.

Варианты:

  • 1 ← (по умолчанию)
  • 2

rss_enabled

boolean

Масштабирование на стороне приема позволяет распределять входящий трафик между несколькими ядрами ЦП.

Варианты:

  • false
  • true ← (по умолчанию)

rss_ipv4_hash

boolean

Если параметр включен, для распределения трафика используется адрес IPv4.

Варианты:

  • false
  • true ← (по умолчанию)

rss_ipv6_ext_hash

boolean

Если параметр включен, для распределения трафика используются расширения IPv6.

Варианты:

  • false
  • true ← (по умолчанию)

rss_ipv6_hash

boolean

Если параметр включен, для распределения трафика используется адрес IPv6.

Варианты:

  • false ← (по умолчанию)
  • true

rss_tcp_ipv4_hash

boolean

Если параметр включен, для распределения трафика используются адрес IPv4 и номер порта TCP.

Варианты:

  • false
  • true ← (по умолчанию)

rss_tcp_ipv6_ext_hash

boolean

Если параметр включен, для распределения трафика используются расширения IPv6 и номер порта TCP.

Варианты:

  • false
  • true ← (по умолчанию)

rss_tcp_ipv6_hash

boolean

Если параметр включен, для распределения трафика используются адрес IPv6 и номер порта TCP.

Варианты:

  • false ← (по умолчанию)
  • true

rss_udp_ipv4_hash

boolean

Если параметр включен, для распределения трафика используются адрес IPv4 и номер порта UDP.

Варианты:

  • false ← (по умолчанию)
  • true

rss_udp_ipv6_hash

boolean

Если параметр включен, для распределения трафика используются адрес IPv6 и номер порта UDP.

Варианты:

  • false ← (по умолчанию)
  • true

rx_queue_count

integer

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

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

rx_ring_size

integer

Количество дескрипторов в каждой очереди приема.

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

state

string

Если задано значение present, будет проверено наличие ресурса и при необходимости он будет создан.

Если задано значение absent, будет проверено отсутствие ресурса и при необходимости он будет удален.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

tags

list / elements=dictionary

Список тегов в формате «Ключ:<заданный пользователем ключ> Значение:<заданное пользователем значение>».

tcp_large_receive

boolean

Включает аппаратную сборку сегментированных пакетов перед их отправкой в ЦП.

Варианты:

  • false
  • true ← (по умолчанию)

tcp_large_send

boolean

Позволяет ЦП отправлять большие пакеты аппаратному обеспечению для сегментации.

Варианты:

  • false
  • true ← (по умолчанию)

tcp_rx_checksum

boolean

Если параметр включен, ЦП передает аппаратному обеспечению контрольные суммы всех пакетов для проверки.

Варианты:

  • false
  • true ← (по умолчанию)

tcp_tx_checksum

boolean

Если параметр включен, ЦП передает все пакеты аппаратному обеспечению для вычисления контрольной суммы.

Варианты:

  • false
  • true ← (по умолчанию)

tx_queue_count

integer

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

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

tx_ring_size

integer

Количество дескрипторов в каждой очереди передачи.

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

uplink_failback_timeout

integer

Тайм-аут возврата на основной канал uplink в секундах, когда для vNIC включено переключение при отказе uplink.

После того как vNIC начал использовать вторичный интерфейс, этот параметр определяет, как долго основной интерфейс должен оставаться доступным, прежде чем система возобновит его использование для vNIC.

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

use_proxy

boolean

Если no, прокси использоваться не будет, даже если он задан в переменной среды на целевых узлах.

Варианты:

  • false
  • true ← (по умолчанию)

validate_certs

boolean

Логический параметр для проверки TLS-сертификата api_uri

Варианты:

  • false
  • true ← (по умолчанию)

vxlan_enabled

boolean

Состояние протокола Virtual Extensible LAN на виртуальном интерфейсе Ethernet.

Варианты:

  • false ← (по умолчанию)
  • true

Примеры

- name: Create a basic Ethernet Adapter Policy
  cisco.intersight.intersight_ethernet_adapter_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "basic-ethernet-adapter-policy"
    description: "Basic Ethernet adapter policy with default settings"
    tags:
      - Key: "Environment"
        Value: "Production"

- name: Create an Ethernet Adapter Policy with VXLAN and advanced features
  cisco.intersight.intersight_ethernet_adapter_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "advanced-ethernet-adapter-policy"
    description: "Advanced Ethernet adapter policy with VXLAN and PTP"
    vxlan_enabled: true
    ptp_enabled: true
    advanced_filter: true
    interrupt_scaling: true
    interrupt_count: 16
    rx_queue_count: 8
    tx_queue_count: 4
    completion_queue_count: 12
    tags:
      - Key: "Environment"
        Value: "Production"
      - Key: "Feature"
        Value: "Advanced"

- name: Create an Ethernet Adapter Policy with RoCE enabled
  cisco.intersight.intersight_ethernet_adapter_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "roce-ethernet-adapter-policy"
    description: "Ethernet adapter policy with RoCE v2 enabled"
    roce_enabled: true
    roce_queue_pairs: 256
    roce_memory_regions: 131072
    roce_resource_groups: 2
    roce_version: 2
    roce_class_of_service: 5
    tags:
      - Key: "Protocol"
        Value: "RoCE"

- name: Create an Ethernet Adapter Policy with EtherChannel pinning
  cisco.intersight.intersight_ethernet_adapter_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "etherchannel-adapter-policy"
    description: "Ethernet adapter policy with EtherChannel pinning"
    etherchannel_pinning_enabled: true
    tx_queue_count: 2
    completion_queue_count: 6
    tags:
      - Key: "Feature"
        Value: "EtherChannel"

- name: Create an Ethernet Adapter Policy with custom RSS settings
  cisco.intersight.intersight_ethernet_adapter_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "custom-rss-adapter-policy"
    description: "Ethernet adapter policy with custom RSS configuration"
    rss_enabled: true
    rss_ipv4_hash: true
    rss_ipv6_hash: false
    rss_tcp_ipv4_hash: false
    rss_tcp_ipv6_hash: false
    rss_udp_ipv4_hash: true
    rss_udp_ipv6_hash: true
    tags:
      - Key: "Feature"
        Value: "CustomRSS"

- name: Delete an Ethernet Adapter Policy
  cisco.intersight.intersight_ethernet_adapter_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "old-ethernet-adapter-policy"
    state: absent

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

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

Ключ

Описание

api_response

dictionary

Ответ API, возвращённый указанным ресурсом.

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

Пример: {"AdvancedFilter": false, "ArfsSettings": {"Enabled": false}, "CompletionQueueSettings": {"Count": 5, "RingSize": 1}, "Description": "Basic Ethernet adapter policy with default settings", "InterruptSettings": {"CoalescingTime": 125, "CoalescingType": "MIN", "Count": 8, "Mode": "MSIx"}, "Moid": "6889f3e8f654d9f7013baae4", "Name": "basic-ethernet-adapter-policy", "NvgreSettings": {"Enabled": false}, "ObjectType": "vnic.EthAdapterPolicy", "PtpSettings": {"Enabled": false}, "RoceSettings": {"Enabled": false}, "RssHashSettings": {"Ipv4Hash": true, "Ipv6ExtHash": false, "Ipv6Hash": true, "TcpIpv4Hash": true, "TcpIpv6ExtHash": false, "TcpIpv6Hash": true, "UdpIpv4Hash": false, "UdpIpv6Hash": false}, "RssSettings": true, "RxQueueSettings": {"Count": 4, "RingSize": 512}, "TcpOffloadSettings": {"LargeReceive": true, "LargeSend": true, "RxChecksum": true, "TxChecksum": true}, "TxQueueSettings": {"Count": 1, "RingSize": 256}, "VxlanSettings": {"Enabled": false}}

Авторы

  • Ron Gershburg (@rgershbu)

Ссылки коллекции

  • Отслеживание проблем
  • Репозиторий (исходный код)

© 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/cisco/intersight/intersight_ethernet_adapter_policy_module.html

Spec-Zone.ru

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