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. Варианты:
|
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 в следующих случаях:
Варианты:
|
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. По умолчанию: |
name string / required | Имя шаблона vNIC. Это имя может содержать от 1 до 16 буквенно-цифровых символов. Вы не можете использовать пробелы или любые специальные символы, кроме - (дефис), “_” (подчеркивание), : (двоеточие) и . (точка). Вы не можете изменить это имя после создания шаблона. |
network_control_policy string | Политика управления сетью, которую должны использовать vNIC, созданные из этого шаблона vNIC. |
org_dn string | org dn (отличительное имя) По умолчанию: |
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 устаревшей версии. Выберите этот параметр, если вы не хотите использовать избыточность. Варианты:
|
state string | Если Если Варианты:
|
stats_policy string | Политика сбора статистики, которую должны использовать vNIC, созданные из этого шаблона vNIC. |
target string | Возможная цель для vNIC, созданных из этого шаблона. Цель определяет, будет ли Cisco UCS Manager автоматически создавать профиль порта VM-FEX с соответствующими настройками для шаблона vNIC. Это может быть одно из следующего: adapter — vNIC применяются ко всем адаптерам. Профиль порта VM-FEX не создается, если вы выберете этот вариант. vm - vNIC применяются ко всем виртуальным машинам. Профиль порта VM-FEX создается, если вы выберете этот вариант. Варианты:
|
template_type string | Поле Тип шаблона. Это может быть одно из следующего: initial-template — vNIC, созданные из этого шаблона, не обновляются, если шаблон изменяется. updating-template - vNIC, созданные из этого шаблона, обновляются, если шаблон изменяется. Варианты:
|
use_proxy boolean | Если Варианты:
|
use_ssl boolean | Если Варианты:
|
username string | Имя пользователя для аутентификации в Cisco UCS Manager. По умолчанию: |
vlans_list list / elements=dictionary | Список VLAN, используемых шаблоном vNIC. |
|
name string |
Имя VLAN (требуется, если state задан). |
|
native string |
Указывает VLAN как native VLAN. Только одна VLAN в списке может быть native VLAN. Варианты:
|
|
state string |
Если задан, проверит наличие VLAN в шаблоне. Если отсутствует, проверит отсутствие VLAN в шаблоне. Варианты:
|
Примеры
- 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
Ссылки на коллекцию
© 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