community.vmware.vmware_content_deploy_template – Развертывание виртуальной машины из шаблона, хранящегося в библиотеке контента.

Примечание

Этот плагин является частью коллекции community.vmware (версия 1.6.0).

Для его установки используйте: ansible-galaxy collection install community.vmware.

Для использования в playbook укажите: community.vmware.vmware_content_deploy_template.

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

Обзор

Модуль для развертывания виртуальной машины из шаблона в библиотеке контента.
Функция библиотеки контента была введена в vSphere версии 6.0.
Функция шаблонов vmtx была введена в vSphere 67U1, а API для клонирования шаблонов из библиотеки контента — в 67U2.
Этот модуль не работает с версиями vSphere, более старыми чем 67U2.
Все переменные и имена объектов VMware чувствительны к регистру.

Требования

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

python >= 2.6
PyVmomi
vSphere Automation SDK

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
cluster строка		Имя кластера в дата-центре, в котором будет размещена развернутая ВМ.
content_library строка		Имя библиотеки контента, в которой находится шаблон. псевдонимы: content_library_src
datacenter строка / обязательно		Имя дата-центра, где будет развернута ВМ.
datastore строка / обязательно		Имя хранилища данных для размещения развернутой ВМ и диска.
folder строка / обязательно		Имя папки в дата-центре, в которую будет размещена развернутая ВМ.
host строка / обязательно		Имя ESX-хоста в дата-центре, в котором будет размещена развернутая ВМ.
hostname строка		Имя хоста или IP-адрес сервера vCenter vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_HOST`.
name строка / обязательно		Имя развертываемой ВМ. псевдонимы: vm_name
password строка		Пароль сервера vCenter vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PASSWORD`. псевдонимы: pass, pwd
port целое число	По умолчанию: 443	Номер порта сервера vCenter vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PORT`.
protocol строка	Варианты: http https ←	Протокол подключения.
resource_pool строка		Имя пула ресурсов в дата-центре, в котором будет размещена развернутая ВМ.
state строка	Варианты: present ← poweredon	Состояние виртуальной машины, развернутой из шаблона в библиотеке контента. Если установлено в `present` и ВМ не существует, то ВМ будет создана. Если установлено в `present` и ВМ существует, никаких действий не будет произведено. Если установлено в `poweredon` и ВМ не существует, то ВМ будет создана в состоянии включения. Если установлено в `poweredon` и ВМ существует, никаких действий не будет произведено.
template строка / обязательно		Имя шаблона, из которого будет развернута ВМ. псевдонимы: template_src
username строка		Имя пользователя сервера vCenter vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_USER`. псевдонимы: admin, user
validate_certs логическое	Варианты: no yes ←	Разрешает подключение, когда сертификаты SSL недействительны. Установите в `False`, когда сертификаты не доверяются. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_VALIDATE_CERTS`.

Примечания

Примечание

Тестировалось на vSphere 6.7 U3

Примеры

- name: Deploy Virtual Machine from template in content library
  community.vmware.vmware_content_deploy_template:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    template: rhel_test_template
    datastore: Shared_NFS_Volume
    folder: vm
    datacenter: Sample_DC_1
    name: Sample_VM
    resource_pool: test_rp
    state: present
  delegate_to: localhost

- name: Deploy Virtual Machine from template in content library with PowerON State
  community.vmware.vmware_content_deploy_template:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    template: rhel_test_template
    content_library: test_content_library
    datastore: Shared_NFS_Volume
    folder: vm
    datacenter: Sample_DC_1
    name: Sample_VM
    resource_pool: test_rp
    state: poweredon
  delegate_to: localhost

Возвращаемые значения

Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:

Ключ	Возвращаемое значение	Описание
vm_deploy_info словарь	при успехе	Сообщение о развертывании виртуальной машины и vm_id Пример: {'msg': "Развернута виртуальная машина 'Sample_VM'.", 'vm_id': 'vm-1009'}

Авторы

Pavan Bidkar (@pgbidkar)

© 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/community/vmware/vmware_content_deploy_template_module.html