Spec-Zone.ru › Ansible

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

Примечание

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

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

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

Чтобы использовать его в плейбуке, укажите: 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" ← (по умолчанию)
  • "user-defined"

description

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

string

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

Длина — не более 256 символов.

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

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

fabric

string

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

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

A-B — использовать Fabric A по умолчанию с включенным переключением при отказе.

B-A — использовать Fabric B по умолчанию с включенным переключением при отказе.

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

- Если домен Cisco UCS работает в режиме коммутатора Ethernet. В этом режиме переключение при отказе фабрики для vNIC не поддерживается.

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

Варианты:

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

hostname

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

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 / обязательный

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

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

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

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

network_control_policy

string

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

org_dn

string

DN организации (различающееся имя)

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

password

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

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

peer_redundancy_template

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

string

Шаблон резервирования пары.

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

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

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

Вторичные шаблоны могут настраивать только не общие свойства (name, description и mac_pool).

pin_group

string

Группа привязки LAN, которую должны использовать интерфейсы 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 при переключении при отказе фабрики.

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

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

secondary — наследует все общие конфигурации из первичного шаблона.

none — поведение устаревшего шаблона vNIC. Выберите этот вариант, если резервирование не требуется.

Варианты:

  • "none" ← (по умолчанию)
  • "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 / элементы=dictionary

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

fabric

string

Обратите внимание: этот параметр не используется и предоставляется только для возможности использовать параметры ucs_vlans в vlan_list.

Фабричная конфигурация VLAN. Допустимы следующие значения:

common — VLAN применяется к обеим фабрикам, для которых используются одинаковые параметры конфигурации.

A — VLAN применяется только к фабрике A.

B — VLAN применяется только к фабрике B.

Варианты:

  • "common"
  • "A"
  • "B"

id

string

Обратите внимание: этот параметр не используется и предоставляется только для возможности использовать параметры ucs_vlans в vlan_list.

Уникальный строковый идентификатор, назначенный VLAN.

multicast_policy

string

Обратите внимание: этот параметр не используется и предоставляется только для возможности использовать параметры ucs_vlans в vlan_list.

Политика многоадресной рассылки, связанная с этой VLAN.

name

string

Имя VLAN (обязательно, если для state задано значение present).

native

string

Назначает VLAN роль собственной VLAN. В списке может быть только одна собственная VLAN.

Варианты:

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

sharing

string

Обратите внимание: этот параметр не используется и предоставляется только для возможности использовать параметры ucs_vlans в vlan_list.

Поле типа совместного использования.

Определяет, разделена ли эта VLAN на частные или вторичные VLAN. Допустимы следующие значения:

none — у этой VLAN нет вторичных или частных VLAN. Это обычная VLAN.

primary — у этой VLAN может быть одна или несколько вторичных VLAN, как показано в области «Вторичные VLAN».

isolated — это частная VLAN, связанная с первичной VLAN. Эта VLAN является изолированной VLAN.

community — эта VLAN может взаимодействовать с другими портами в той же VLAN сообщества, а также с портом с неограниченным доступом. Эта VLAN является VLAN сообщества.

Варианты:

  • "none"
  • "primary"
  • "isolated"
  • "community"

state

string

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

Если задано значение absent, проверяет отсутствие 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–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/cisco/ucs/ucs_vnic_template_module.html

Spec-Zone.ru

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