Spec-Zone.ru › Ansible

cisco.ucs.ucs_vnic_template модуль — Настройка шаблонов vNIC на Cisco UCS Manager

Примечание

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

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

Для установки используйте: ansible-galaxy collection install cisco.ucs. Для использования этого модуля необходимы дополнительные требования. Подробнее см. Требования.

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

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

Обзор

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

Требования

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

  • ucsmsdk

Параметры

Параметр

Комментарии

cdn_name

string

Имя CDN, используемое, когда cdn_source установлено в user-defined.

cdn_source

string

Поле источника CDN.

Это может быть один из следующих вариантов:

vnic-name - Использует имя шаблона vNIC экземпляра vNIC в качестве имени CDN. Это вариант по умолчанию.

user-defined - Использует имя CDN, определяемое пользователем, для шаблона vNIC. Если выбран этот параметр, также необходимо указать cdn_name.

Варианты:

  • "vnic-name" ← (default)
  • "user-defined"

description

aliases: descr

string

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

Введите до 256 символов.

Вы можете использовать любые символы или пробелы, за исключением следующих:

` (акцент), (обратная косая черта), ^ (циркумфлекс), ” (двойная кавычка), = (знак равенства), > (больше чем), < (меньше чем) или ‘ (одинарная кавычка).

fabric

string

Поле Fabric ID, указывающее на коммутатор Fabric Interconnect, связанный с vNIC, созданными из этого шаблона.

Если вы хотите включить отработку отказа Fabric на vNIC, созданных из этого шаблона, используйте один из следующих вариантов:

A-B для использования Fabric A по умолчанию с включенной отработкой отказа.

B-A для использования Fabric B по умолчанию с включенной отработкой отказа.

Не включайте отработку отказа Fabric vNIC в следующих случаях:

  • Если домен Cisco UCS работает в режиме коммутатора Ethernet. Отработка отказа Fabric vNIC не поддерживается в этом режиме.
  • Если вы планируете связать один или несколько vNIC, созданных из этого шаблона, с сервером с адаптером, который не поддерживает отработку отказа Fabric.

Варианты:

  • "A" ← (default)
  • "B"
  • "A-B"
  • "B-A"

hostname

string / required

IP-адрес или имя хоста Cisco UCS Manager.

Модули могут использоваться с эмулятором платформы UCS https://cs.co/ucspe

mac_pool

string

Пул MAC-адресов, который должны использовать vNIC, созданные из этого шаблона vNIC.

mtu

string

Поле MTU.

Максимальный размер передаваемого блока (MTU) или размер пакета, который должны использовать vNIC, созданные из этого шаблона vNIC.

Введите строку от ‘1500’ до ‘9000’.

Если у шаблона vNIC есть связанная политика QoS, указанный здесь MTU должен быть равен или меньше MTU, указанного в системном классе QoS.

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

name

string / required

Имя шаблона vNIC.

Это имя может содержать от 1 до 16 буквенно-цифровых символов.

Вы не можете использовать пробелы или любые специальные символы, кроме - (дефис), “_” (подчеркивание), : (двоеточие) и . (точка).

Вы не можете изменить это имя после создания шаблона.

network_control_policy

string

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

org_dn

string

org dn (отличительное имя)

По умолчанию: "org-root"

password

string / required

Пароль для аутентификации Cisco UCS Manager.

peer_redundancy_template

aliases: peer_redundancy_templ

string

Шаблон избыточности узла.

Имя шаблона vNIC, использующего общую конфигурацию с этим шаблоном.

Если redundancy_type имеет значение primary, следует указать имя вторичного шаблона.

Если redundancy_type имеет значение secondary, следует указать имя основного шаблона.

Вторичные шаблоны могут настраивать только неразделяемые свойства (имя, описание и mac_pool).

pin_group

string

Группа LAN pin, которую должны использовать vNIC, созданные из этого шаблона vNIC.

port

integer

Номер порта, который будет использоваться во время соединения (по умолчанию используется 443 для соединения https и 80 для соединения http).

proxy

string

Если use_proxy имеет значение no, указывает прокси-сервер, который будет использоваться для соединения. например, ‘http://proxy.xy.z:8080’

qos_policy

string

Политика качества обслуживания (QoS), которую должны использовать vNIC, созданные из этого шаблона vNIC.

redundancy_type

string

Тип избыточности, используемый для пар избыточности vNIC во время отработки отказа Fabric.

Это может быть один из следующих вариантов:

primary — Создает конфигурации, которые можно совместно использовать со вторичным шаблоном.

secondary — Все общие конфигурации наследуются от основного шаблона.

none - Поведение шаблона vNIC устаревшей версии. Выберите этот параметр, если вы не хотите использовать избыточность.

Варианты:

  • "none" ← (default)
  • "primary"
  • "secondary"

state

string

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

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

Варианты:

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

stats_policy

string

Политика сбора статистики, которую должны использовать vNIC, созданные из этого шаблона vNIC.

target

string

Возможная цель для vNIC, созданных из этого шаблона.

Цель определяет, будет ли Cisco UCS Manager автоматически создавать профиль порта VM-FEX с соответствующими настройками для шаблона vNIC.

Это может быть одно из следующего:

adapter — vNIC применяются ко всем адаптерам. Профиль порта VM-FEX не создается, если вы выберете этот вариант.

vm - vNIC применяются ко всем виртуальным машинам. Профиль порта VM-FEX создается, если вы выберете этот вариант.

Варианты:

  • "adapter" ← (по умолчанию)
  • "vm"

template_type

string

Поле Тип шаблона.

Это может быть одно из следующего:

initial-template — vNIC, созданные из этого шаблона, не обновляются, если шаблон изменяется.

updating-template - vNIC, созданные из этого шаблона, обновляются, если шаблон изменяется.

Варианты:

  • "initial-template" ← (по умолчанию)
  • "updating-template"

use_proxy

boolean

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

Варианты:

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

use_ssl

boolean

Если no, вместо соединения HTTPS будет использоваться HTTP.

Варианты:

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

username

string

Имя пользователя для аутентификации в Cisco UCS Manager.

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

vlans_list

list / elements=dictionary

Список VLAN, используемых шаблоном vNIC.

name

string

Имя VLAN (требуется, если state задан).

native

string

Указывает VLAN как native VLAN. Только одна VLAN в списке может быть native VLAN.

Варианты:

  • "no" ← (по умолчанию)
  • "yes"

state

string

Если задан, проверит наличие VLAN в шаблоне.

Если отсутствует, проверит отсутствие VLAN в шаблоне.

Варианты:

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

Примеры

- 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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/cisco/ucs/ucs_vnic_template_module.html

Spec-Zone.ru

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