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

Новая в версии 2.9.

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

Обзор

Модуль для развёртывания виртуальной машины из шаблона в библиотеке содержимого.
Функция Библиотеки содержимого введена в vSphere 6.0, поэтому этот модуль не поддерживается в более ранних версиях vSphere.
Все переменные и имена объектов VMware чувствительны к регистру.

Требования

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

python >= 2.6
PyVmomi
vSphere Automation SDK

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
cluster строка		Имя кластера в центре обработки данных, в котором следует разместить развернутую ВМ.
datacenter строка / обязательно		Имя центра обработки данных, где должна быть развернута ВМ.
datastore строка / обязательно		Имя хранилища данных для размещения развернутой ВМ и диска.
folder строка / обязательно		Имя папки в центре обработки данных, в которую следует разместить развернутую ВМ.
host строка / обязательно		Имя ESX-хоста в центре обработки данных, в котором следует разместить развернутую ВМ.
hostname строка		Имя хоста или IP-адрес сервера vCenter vSphere. Если значение не указано в задаче, используется значение переменной среды `VMWARE_HOST`.
name строка / обязательно		Имя развёртываемой ВМ. псевдонимы: vm_name
password строка		Пароль сервера vCenter vSphere. Если значение не указано в задаче, используется значение переменной среды `VMWARE_PASSWORD`. псевдонимы: pass, pwd
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 недействительны. Устанавливается в `no`, когда сертификаты ненадёжны. Если значение не указано в задаче, используется значение переменной среды `VMWARE_VALIDATE_CERTS`.

Примечания

Примечание

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

Примеры

- name: Deploy Virtual Machine from template in content library
  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
    validate_certs: False
    state: present
  delegate_to: localhost

- name: Deploy Virtual Machine from template in content library with PowerON State
  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
    validate_certs: False
    state: poweredon
  delegate_to: localhost

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

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

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

Статус

Гарантия обратной совместимости интерфейса этого модуля не предоставляется. [превью]
Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

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.9/modules/vmware_content_deploy_template_module.html