Spec-Zone.ru › Ansible

Модуль cisco.intersight.intersight_vnic_template — управление шаблонами vNIC для Cisco Intersight

Примечание

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

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

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

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

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

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

  • Создание, обновление и удаление шаблонов vNIC в Cisco Intersight.
  • Шаблоны vNIC задают конфигурации сетевых интерфейсов, которые можно использовать в политиках подключения к LAN.
  • Шаблоны предоставляют стандартизированный способ настройки vNIC с единообразными сетевыми политиками и политиками адаптеров.
  • Шаблоны vNIC применимы только для развёртываний с подключением к FI (Fabric Interconnect).
  • Подробнее см. в документации Cisco Intersight.

Параметры

Параметр

Комментарии

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"

cdn_source

string

Источник CDN. Можно указать значение вручную или использовать имя vNIC.

Допустимые значения:

  • "vnic" ← (по умолчанию)
  • "user"

cdn_value

string

Значение CDN, если cdn_source равно ‘user’.

connection_type

string

Тип подключения для vNIC.

Допустимые значения:

  • "none" ← (по умолчанию)
  • "usnic"
  • "vmq"
  • "sriov"

description

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

string

Описание шаблона vNIC, заданное пользователем.

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

enable_override

boolean

Если параметр включён, конфигурация производных экземпляров может переопределять конфигурацию шаблона.

Допустимые значения:

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

eth_adapter_policy_name

string

Связь с политикой Ethernet-адаптера.

Обязательно, если state имеет значение ‘present’.

eth_qos_policy_name

string

Связь с политикой QoS Ethernet.

Обязательно, если state имеет значение ‘present’.

fabric_eth_network_control_policy_name

string

Связь с политикой управления сетью Fabric Ethernet.

Обязательно, если state имеет значение ‘present’.

fabric_eth_network_group_policy_name

string

Связь с политикой группы Fabric Ethernet.

Обязательно, если state имеет значение ‘present’.

failover_enabled

boolean

Включает автоматическое переключение vNIC на резервный Fabric Interconnect при отказе основного пути.

Переключение применимо только к Cisco VIC, подключённым к кластеру Fabric Interconnect.

Допустимые значения:

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

iscsi_boot_policy_name

string

Связь с политикой загрузки iSCSI.

mac_pool_name

string

Пул MAC-адресов, назначенный шаблону vNIC.

Обязательно, если state имеет значение ‘present’.

name

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

Имя, назначенное шаблону vNIC.

Должно быть уникальным в пределах организации.

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

organization

string

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

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

Для организации по умолчанию используйте ‘default’.

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

pin_group_name

string

Имя группы закрепления (pingroup), связанной с vNIC для статического закрепления.

При развёртывании LCP будет разрешено имя pingroup и получен соответствующий восходящий порт или канал портов для закрепления трафика vNIC.

sriov_settings

dictionary

Параметры SR-IOV, если connection_type имеет значение ‘sriov’.

comp_count_per_vf

integer

Количество очередей завершения на VF (1–16).

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

enabled

boolean

Включить SR-IOV.

Допустимые значения:

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

int_count_per_vf

integer

Количество прерываний на VF (1–16).

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

rx_count_per_vf

integer

Количество очередей приёма на VF (1–8).

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

tx_count_per_vf

integer

Количество очередей передачи на VF (1–8).

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

vf_count

integer

Количество виртуальных функций (1–64).

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

state

string

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

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

Допустимые значения:

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

switch_id

string

Порт фабрики, с которым будет связан vNIC.

Допустимые значения:

  • "A" ← (по умолчанию)
  • "B"

tags

list / элементы=dictionary

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

use_proxy

boolean

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

Допустимые значения:

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

usnic_settings

dictionary

Параметры USNIC, если connection_type имеет значение ‘usnic’.

Обязательно, если connection_type имеет значение ‘usnic’.

cos

integer

Класс обслуживания для трафика на usNIC.

Допустимые значения:

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

count

integer

Количество создаваемых интерфейсов usNIC.

Если usNIC включён, допустимы значения от 1 до 225.

Если usNIC отключён, значение по умолчанию — 0.

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

usnic_adapter_policy_name

string

Политика Ethernet-адаптера, связываемая с интерфейсами usNIC.

Обязательно, если connection_type имеет значение ‘usnic’.

validate_certs

boolean

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

Допустимые значения:

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

vmq_settings

dictionary

Параметры VMQ, если connection_type имеет значение ‘vmq’.

enabled

boolean

Включить VMQ.

Допустимые значения:

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

multi_queue_support

boolean

Включает поддержку нескольких очередей виртуальной машины на виртуальном интерфейсе.

VMMQ позволяет настроить несколько очередей ввода-вывода для одной виртуальной машины и тем самым распределять трафик между несколькими ядрами ЦП виртуальной машины.

Допустимые значения:

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

num_interrupts

integer

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

Рекомендуемое значение — число потоков ЦП или логических процессоров, доступных на сервере.

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

num_sub_vnics

integer

Количество подчинённых vNIC (0–64).

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

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

num_vmqs

integer

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

Количество VMQ на адаптер должно быть на единицу больше максимального количества сетевых адаптеров виртуальных машин.

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

vmmq_adapter_policy_name

string

Имя политики адаптера VMMQ.

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

Примеры

- name: Create a basic vNIC Template
  cisco.intersight.intersight_vnic_template:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
    name: "basic-vnic-template"
    description: "Basic vNIC template for production servers"
    enable_override: false
    switch_id: "A"
    failover_enabled: false
    cdn_source: "vnic"
    mac_pool_name: "default-mac-pool"
    fabric_eth_network_group_policy_name: "default-network-group"
    fabric_eth_network_control_policy_name: "default-network-control"
    eth_qos_policy_name: "default-qos-policy"
    eth_adapter_policy_name: "default-adapter-policy"
    connection_type: "none"
    tags:
      - Key: "Environment"
        Value: "Production"
      - Key: "Site"
        Value: "DataCenter-A"
    state: present

- name: Create a vNIC Template with custom CDN
  cisco.intersight.intersight_vnic_template:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
    name: "custom-cdn-template"
    description: "vNIC template with custom CDN value"
    enable_override: true
    switch_id: "B"
    failover_enabled: true
    cdn_source: "user"
    cdn_value: "Management-NIC"
    mac_pool_name: "mgmt-mac-pool"
    fabric_eth_network_group_policy_name: "mgmt-network-group"
    fabric_eth_network_control_policy_name: "mgmt-network-control"
    eth_qos_policy_name: "mgmt-qos-policy"
    eth_adapter_policy_name: "mgmt-adapter-policy"
    iscsi_boot_policy_name: "mgmt-iscsi-boot-policy"
    connection_type: "none"
    state: present

- name: Create a vNIC Template with USNIC
  cisco.intersight.intersight_vnic_template:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "usnic-template"
    description: "vNIC template with USNIC configuration"
    enable_override: false
    switch_id: "A"
    mac_pool_name: "hpc-mac-pool"
    fabric_eth_network_group_policy_name: "hpc-network-group"
    fabric_eth_network_control_policy_name: "hpc-network-control"
    eth_qos_policy_name: "hpc-qos-policy"
    eth_adapter_policy_name: "hpc-adapter-policy"
    connection_type: "usnic"
    usnic_settings:
      count: 0
      cos: 5
      usnic_adapter_policy_name: "hpc-adapter-policy"
    state: present

- name: Create a vNIC Template with VMQ
  cisco.intersight.intersight_vnic_template:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "vmq-template"
    description: "vNIC template with VMQ configuration"
    enable_override: false
    switch_id: "A"
    mac_pool_name: "vm-mac-pool"
    fabric_eth_network_group_policy_name: "vm-network-group"
    fabric_eth_network_control_policy_name: "vm-network-control"
    eth_qos_policy_name: "vm-qos-policy"
    eth_adapter_policy_name: "vm-adapter-policy"
    connection_type: "vmq"
    vmq_settings:
      enabled: true
      multi_queue_support: false
      num_interrupts: 16
      num_vmqs: 4
    state: present

- name: Create a vNIC Template with VMQ multi-queue support
  cisco.intersight.intersight_vnic_template:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "vmq-multiqueue-template"
    description: "vNIC template with VMQ multi-queue configuration"
    enable_override: true
    switch_id: "B"
    mac_pool_name: "vm-mac-pool"
    fabric_eth_network_group_policy_name: "vm-network-group"
    fabric_eth_network_control_policy_name: "vm-network-control"
    eth_qos_policy_name: "vm-qos-policy"
    eth_adapter_policy_name: "vm-adapter-policy"
    connection_type: "vmq"
    vmq_settings:
      enabled: true
      multi_queue_support: true
      num_sub_vnics: 64
      vmmq_adapter_policy_name: "vmmq-adapter-policy"
    state: present

- name: Create a vNIC Template with SR-IOV
  cisco.intersight.intersight_vnic_template:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "sriov-template"
    description: "vNIC template with SR-IOV configuration"
    enable_override: false
    switch_id: "A"
    mac_pool_name: "sriov-mac-pool"
    fabric_eth_network_group_policy_name: "sriov-network-group"
    fabric_eth_network_control_policy_name: "sriov-network-control"
    eth_qos_policy_name: "sriov-qos-policy"
    eth_adapter_policy_name: "sriov-adapter-policy"
    connection_type: "sriov"
    sriov_settings:
      enabled: true
      vf_count: 64
      rx_count_per_vf: 4
      tx_count_per_vf: 1
      comp_count_per_vf: 5
      int_count_per_vf: 8
    state: present

- name: Create a vNIC Template with pin group
  cisco.intersight.intersight_vnic_template:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
    name: "vnic-pinned-template"
    description: "vNIC template with static pinning"
    enable_override: false
    switch_id: "A"
    failover_enabled: false
    mac_pool_name: "default-mac-pool"
    fabric_eth_network_group_policy_name: "default-network-group"
    fabric_eth_network_control_policy_name: "default-network-control"
    eth_qos_policy_name: "default-qos-policy"
    eth_adapter_policy_name: "default-adapter-policy"
    pin_group_name: "pingroup-a"
    connection_type: "none"
    state: present

- name: Delete a vNIC Template
  cisco.intersight.intersight_vnic_template:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "old-vnic-template"
    state: absent

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

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

Ключ

Описание

api_response

dictionary

Результат ответа API, возвращённый для указанного ресурса.

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

Пример: {"api_response": {"Cdn": {"Source": "vnic"}, "EnableOverride": false, "FailoverEnabled": false, "MacPool": {"Name": "default-mac-pool", "ObjectType": "macpool.Pool"}, "Name": "test-vnic-template", "ObjectType": "vnic.VnicTemplate", "SwitchId": "A", "Tags": [{"Key": "Environment", "Value": "Production"}]}}

Авторы

  • 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_vnic_template_module.html

Spec-Zone.ru

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