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	Поле Fabric ID, указывающее соединение Fabric, связанное с 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. Имя шаблона vNIC, разделяющего конфигурацию с этим шаблоном. Если redundancy_type равен primary, необходимо указать имя вторичного шаблона. Если redundancy_type равен secondary, необходимо указать имя первичного шаблона. Вторичные шаблоны могут настраивать только несовместные свойства (имя, описание и mac_pool). псевдонимы: peer_redundancy_templ
pin_group строка		Группа LAN-подключений, которую должны использовать 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	Тип резервирования, используемый для пар резервирования vNIC во время failover Fabric. Это может быть одно из следующих значений: primary — Создает конфигурации, которые можно разделить со вторичным шаблоном. secondary — Все общие конфигурации наследуются от первичного шаблона. none - Поведение шаблона vNIC по умолчанию. Выберите этот вариант, если вы не хотите использовать резервирование.
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`, будет использоваться HTTP-соединение вместо стандартного HTTPS-соединения.
username строка	По умолчанию: "admin"	Имя пользователя для аутентификации Cisco UCS Manager.
vlans_list строка		Список VLAN, используемых шаблоном vNIC. Каждый элемент списка имеет следующие подварианты: = name Имя VLAN (обязательно). - native Указывает VLAN как собственную VLAN. Только одна VLAN в списке может быть собственной VLAN. [choices: 'no', 'yes'] [По умолчанию: 'no'] - state Если присутствует, проверит наличие VLAN в шаблоне. Если отсутствует, проверит отсутствие VLAN в шаблоне. choices: [present, absent] default: 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/cisco/ucs/ucs_vnic_template_module.html