cisco.ucs.ucs_vnic_template – Настройка шаблонов vNIC в Cisco UCS Manager

Примечание

Этот плагин входит в состав коллекции cisco.ucs (версия 1.6.0).

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

Для использования в книге задач укажите: cisco.ucs.ucs_vnic_template.

Новое в версии 2.5: коллекции cisco.ucs

Обзор
Требования
Параметры
Примеры

Обзор

Настройка шаблонов vNIC в Cisco UCS Manager.

Требования

Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.

ucsmsdk

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
cdn_name строка		Имя CDN, используемое при cdn_source установлено в пользовательское.
cdn_source строка	Варианты: vnic-name ← пользовательское	Поле Источник CDN. Может принимать следующие значения: vnic-name - Использует имя шаблона vNIC экземпляра vNIC в качестве имени CDN. Это значение по умолчанию. пользовательское - Использует пользовательское имя CDN для шаблона vNIC. Если выбран этот параметр, также необходимо указать cdn_name.
description строка		Пользовательское описание шаблона vNIC. Введите до 256 символов. Можно использовать любые символы или пробелы, кроме следующих: ` (гравис), (обратный слэш), ^ (знак возведения в степень), " (двойные кавычки), = (знак равенства), > (больше), < (меньше) или ' (одинарная кавычка). псевдонимы: descr
fabric строка	Варианты: A ← B A-B B-A	Поле ID Fabric, определяющее Fabric interconnect, связанную с vNIC, созданными из этого шаблона. Если вы хотите включить failover Fabric для vNIC, созданных из этого шаблона, используйте следующие: A-B для использования Fabric A по умолчанию с включенным failover. B-A для использования Fabric B по умолчанию с включенным failover. Не включайте failover Fabric vNIC в следующих случаях: - Если домен Cisco UCS работает в режиме Ethernet-коммутатора. Failover Fabric vNIC не поддерживается в этом режиме. - Если вы планируете связать один или несколько vNIC, созданных из этого шаблона, с сервером с адаптером, который не поддерживает failover Fabric.
hostname строка / обязательно		IP-адрес или имя хоста Cisco UCS Manager. Модули могут использоваться с эмулятором платформы UCS https://cs.co/ucspe
mac_pool строка		Пул MAC-адресов, который должны использовать vNIC, созданные из этого шаблона vNIC.
mtu строка	По умолчанию: "1500"	Поле MTU. Максимальный размер передаваемого блока (MTU) или размер пакета, который должны использовать vNIC, созданные из этого шаблона vNIC. Введите строку от '1500' до '9000'. Если для шаблона vNIC задана политика QoS, указанный здесь MTU должен быть равен или меньше MTU, указанному в классе QoS системы.
name строка / обязательно		Имя шаблона vNIC. Это имя может содержать от 1 до 16 буквенно-цифровых символов. Пробелы и специальные символы, кроме - (тире), _ (подчеркивание), : (двоеточие) и . (точка), недопустимы. Изменить это имя после создания шаблона нельзя.
network_control_policy строка		Политика управления сетью, которую должны использовать vNIC, созданные из этого шаблона vNIC.
org_dn строка	По умолчанию: "org-root"	Org dn (имя по каталогу)
password строка / обязательно		Пароль для аутентификации в Cisco UCS Manager.
peer_redundancy_template строка		Шаблон Peer Redundancy. Имя шаблона vNIC, разделяющего конфигурацию с этим шаблоном. Если redundancy_type является primary, необходимо указать имя вторичного шаблона. Если redundancy_type является secondary, необходимо указать имя первичного шаблона. Вторичные шаблоны могут настраивать только несвязанные свойства (имя, описание и mac_pool). псевдонимы: peer_redundancy_templ
pin_group строка		Группа LAN pin, которую должны использовать vNIC, созданные из этого шаблона vNIC.
port целое число		Порт, который будет использоваться во время подключения (по умолчанию используется 443 для HTTPS и 80 для HTTP-подключения).
proxy строка		Если use_proxy равен 'no', указывает прокси, который будет использоваться для подключения. Например, 'http://proxy.xy.z:8080'
qos_policy строка		Политика качества обслуживания (QoS), которую должны использовать vNIC, созданные из этого шаблона vNIC.
redundancy_type строка	Варианты: none ← primary secondary	Тип Redundancy, используемый для пар vNIC redundancy во время failover Fabric. Может принимать следующие значения: primary — Создает конфигурации, которые могут быть разделены со вторичным шаблоном. secondary — Все общие конфигурации наследуются от первичного шаблона. none - Поведение шаблона vNIC legacy. Выберите этот параметр, если вы не хотите использовать redundancy.
state строка	Варианты: present ← absent	Если `present`, проверит наличие шаблонов vNIC и создаст их, если необходимо. Если `absent`, проверит отсутствие шаблонов vNIC и удалит их, если необходимо.
stats_policy строка	По умолчанию: "default"	Политика сбора статистики, которую должны использовать vNIC, созданные из этого шаблона vNIC.
target строка	По умолчанию: "adapter"	Возможная цель для vNIC, созданных из этого шаблона. Цель определяет, создаст ли Cisco UCS Manager автоматически профиль порта VM-FEX с соответствующими параметрами для шаблона vNIC. Может принимать следующие значения: adapter — vNIC применяются ко всем адаптерам. Профиль порта VM-FEX не создается, если выбран этот параметр. vm - vNIC применяются ко всем виртуальным машинам. Профиль порта VM-FEX создается, если выбран этот параметр.
template_type строка	Варианты: initial-template ← updating-template	Поле Тип шаблона. Может принимать следующие значения: initial-template — vNIC, созданные из этого шаблона, не обновляются, если шаблон меняется. updating-template - vNIC, созданные из этого шаблона, обновляются, если шаблон меняется.
use_proxy логическое значение	Варианты: no yes ←	Если `no`, прокси, определенный в системной переменной окружения, не будет использоваться.
use_ssl логическое значение	Варианты: no yes ←	Если `no`, вместо подключения по умолчанию по протоколу HTTPS будет использоваться HTTP-соединение.
username строка	По умолчанию: "admin"	Имя пользователя для аутентификации в Cisco UCS Manager.
vlans_list строка		Список VLAN, используемых шаблоном vNIC. Каждый элемент списка содержит следующие подварианты: = name Имя VLAN (необходимо). - native Указывает VLAN как native VLAN. Только один VLAN в списке может быть native VLAN. [Варианты: 'no', 'yes'] [По умолчанию: 'no'] - state При наличии проверит наличие VLAN в шаблоне. При отсутствии проверит отсутствие VLAN в шаблоне. Варианты: [present, absent] По умолчанию: present

Примеры

- name: Configure vNIC template
  cisco.ucs.ucs_vnic_template:
    hostname: 172.16.143.150
    username: admin
    password: password
    name: vNIC-A
    fabric: A
    vlans_list:
    - name: default
      native: 'yes'

- name: Configure vNIC template with failover
  cisco.ucs.ucs_vnic_template:
    hostname: 172.16.143.150
    username: admin
    password: password
    name: vNIC-A-B
    fabric: A-B
    vlans_list:
    - name: default
      native: 'yes'
      state: present

- name: Remove vNIC template
  cisco.ucs.ucs_vnic_template:
    hostname: 172.16.143.150
    username: admin
    password: password
    name: vNIC-A
    state: absent

- name: Remove another vNIC template
  cisco.ucs.ucs_vnic_template:
    hostname: 172.16.143.150
    username: admin
    password: password
    name: vNIC-A-B
    state: absent

- name: Remove VLAN from template
  cisco.ucs.ucs_vnic_template:
    hostname: 172.16.143.150
    username: admin
    password: password
    name: vNIC-A-B
    fabric: A-B
    vlans_list:
    - name: default
      native: 'yes'
      state: absent

Авторы

David Soper (@dsoper2)
John McDonough (@movinalot)
CiscoUcs (@CiscoUcs)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/cisco/ucs/ucs_vnic_template_module.html