ucs_vnic_template - Настройка шаблонов vNIC на Cisco UCS Manager
Новое в версии 2.5.
Обзор
- Настраивает шаблоны vNIC на Cisco UCS Manager.
- Примеры можно использовать с эмулятором платформы UCS https://communities.cisco.com/ucspe.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- ucsmsdk
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| cdn_name | Имя CDN, используемое при cdn_source установлено в пользовательское. | |
| cdn_source |
| Поле Источник CDN. Может принимать одно из следующих значений: vnic-name - Использует имя шаблона vNIC экземпляра vNIC в качестве имени CDN. Это значение по умолчанию. пользовательское - Использует пользовательское имя CDN для шаблона vNIC. Если выбран этот вариант, также необходимо указать cdn_name. |
| description | Пользовательское описание шаблона vNIC. Введите до 256 символов. Можно использовать любые символы или пробелы, кроме следующих: ` (ударение), (обратный слэш), ^ (знак вверху), " (двойная кавычка), = (знак равенства), > (больше чем), < (меньше чем) или ' (одинарная кавычка). псевдонимы: descr | |
| fabric |
| Поле Fabric ID, указывающее на соединитель Fabric, связанный с созданными из этого шаблона vNIC. Если требуется включить переключение Fabric на vNIC, созданных из этого шаблона, используйте одно из следующих значений: A-B для использования Fabric A по умолчанию с включенным переключением. B-A для использования Fabric B по умолчанию с включенным переключением. Не включайте переключение Fabric vNIC в следующих случаях: - Если домен Cisco UCS работает в режиме коммутатора Ethernet. Переключение Fabric vNIC не поддерживается в этом режиме. - Если планируется связать один или несколько созданных из этого шаблона vNIC с сервером, адаптер которого не поддерживает переключение Fabric. |
| hostname str обязательно | IP-адрес или имя хоста Cisco UCS Manager. | |
| mac_pool | Пул MAC-адресов, который должны использовать созданные из этого шаблона vNIC. | |
| mtu | По умолчанию: "1500" | Поле MTU. Максимальный размер блока (MTU) или размер пакета, который должны использовать созданные из этого шаблона vNIC. Введите строку от '1500' до '9000'. Если шаблон vNIC имеет связанную политику QoS, указанное здесь MTU должно быть равно или меньше MTU, указанного в системе QoS. |
| name обязательно | Имя шаблона vNIC. Это имя может содержать от 1 до 16 буквенно-цифровых символов. Нельзя использовать пробелы или специальные символы, кроме - (дефис), _ (нижний подчеркивание), : (двоеточие) и . (точка). Изменить это имя после создания шаблона нельзя. | |
| network_control_policy | Политика управления сетью, которую должны использовать созданные из этого шаблона vNIC. | |
| org_dn | По умолчанию: "org-root" | Org dn (имя по каталогу) |
| password str обязательно | Пароль для аутентификации Cisco UCS Manager. | |
| peer_redundancy_template | Шаблон резервирования Peer. Имя шаблона vNIC, который совместно использует конфигурацию с этим шаблоном. Если тип резервирования — первичный, следует указать имя вторичного шаблона. Если тип резервирования — вторичный, следует указать имя первичного шаблона. Вторичные шаблоны могут настраивать только несвязные свойства (имя, описание и mac_pool). псевдонимы: peer_redundancy_templ | |
| pin_group | Группа пинов LAN, которую должны использовать созданные из этого шаблона vNIC. | |
| port int | Номер порта, используемый во время подключения (по умолчанию используется 443 для https и 80 для http подключения). | |
| proxy str | Если use_proxy — no, указывает прокси, который следует использовать для подключения. Например, 'http://proxy.xy.z:8080' | |
| qos_policy | Политика качества обслуживания (QoS), которую должны использовать созданные из этого шаблона vNIC. | |
| redundancy_type |
| Тип резервирования, используемый для пар резервирования vNIC во время переключения Fabric. Может принимать одно из следующих значений: primary — Создает конфигурации, которые могут быть совместно использованы со вторичным шаблоном. secondary — Все общие конфигурации наследуются от первичного шаблона. none - Поведение устаревшего шаблона vNIC. Выберите этот вариант, если не хотите использовать резервирование. |
| state |
| Если present, проверит наличие шаблонов vNIC и создаст их при необходимости.Если absent, проверит отсутствие шаблонов vNIC и удалит их при необходимости. |
| stats_policy | По умолчанию: "default" | Политика сбора статистики, которую должны использовать созданные из этого шаблона vNIC. |
| target | По умолчанию: "adapter" | Возможная цель для созданных из этого шаблона vNIC. Цель определяет, создает ли Cisco UCS Manager автоматически профиль порта VM-FEX с соответствующими настройками для шаблона vNIC. Может принимать одно из следующих значений: adapter — vNIC применяются ко всем адаптерам. Если выбран этот вариант, профиль порта VM-FEX не создается. vm - vNIC применяются ко всем виртуальным машинам. Если выбран этот вариант, профиль порта VM-FEX создается. |
| template_type |
| Поле Тип шаблона. Может принимать одно из следующих значений: initial-template — vNIC, созданные из этого шаблона, не обновляются при изменении шаблона. updating-template - vNIC, созданные из этого шаблона, обновляются при изменении шаблона. |
| use_proxy bool |
| Если no, прокси, определенный переменной среды системы, не используется. |
| use_ssl bool |
| Если no, вместо стандартного подключения HTTPS будет использоваться HTTP-подключение. |
| username str | По умолчанию: "admin" | Имя пользователя для аутентификации Cisco UCS Manager. |
| vlans_list | Список VLAN, используемых шаблоном vNIC. Каждый элемент списка имеет следующие подварианты: = name Имя VLAN (обязательно). - native Указывает VLAN как основную VLAN. Только один VLAN в списке может быть основной VLAN. [choices: 'no', 'yes'] [По умолчанию: 'no'] |
Примеры
- name: Configure vNIC template
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
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'
- name: finance
- name: Remove vNIC template
ucs_vnic_template:
hostname: 172.16.143.150
username: admin
password: password
name: vNIC-A
state: absent
- name: Remove another vNIC template
ucs_vnic_template:
hostname: 172.16.143.150
username: admin
password: password
name: vNIC-A-B
state: absent
Статус
Этот модуль помечен как предварительная версия, что означает, что он не гарантирует обратную совместимость.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Более подробную информацию см. в разделе Техническое обслуживание и поддержка модулей.
Список других модулей, также поддерживаемых сообществом Ansible, см. в разделе здесь.
Автор
- David Soper (@dsoper2)
- 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.6/modules/ucs_vnic_template_module.html