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

Примечание

Этот плагин входит в коллекцию community.vmware (версия 1.7.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 строка		Имя кластера в центрі данных, в котором будет размещена развернутая ВМ. Требуется, если не указан параметр resource_pool.
content_library строка		Имя библиотеки содержимого, где находится шаблон. Псевдонимы: content_library_src
datacenter строка / обязательно		Имя центра данных, где будет развернута ВМ.
datastore строка		Имя хранилища данных для размещения развернутой ВМ и дисков. Требуется, если не указан параметр datastore_cluster.
datastore_cluster строка добавлен в 1.7.0 community.vmware		Имя кластера хранилища данных для размещения развернутой ВМ и дисков. Убедитесь, что Storage DRS включен для рекомендуемого хранилища данных из данного кластера хранилищ. Если Storage DRS не включен, выбирается хранилище данных с наибольшим свободным объёмом. Требуется, если не указан параметр datastore.
folder строка / обязательно		Имя папки в центре данных, в которую будет размещена развернутая ВМ.
host строка		Имя ESX хоста в центре данных, в котором будет размещена развернутая ВМ. Хост должен быть членом кластера, содержащего пул ресурсов. Требуется вместе с resource_pool для получения подробностей о пуле ресурсов. Будет использоваться как дополнительная информация, когда существуют пулы ресурсов с одинаковым именем.
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 строка		Имя пула ресурсов в центре данных, в котором будет размещена развернутая ВМ. Требуется, если не указан параметр cluster. Для имен пулов ресурсов по умолчанию или не уникальных имен укажите host и cluster. `Resources` — имя пула ресурсов по умолчанию.
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. Пример: {'msg': "Развернута виртуальная машина 'Sample_VM'.", 'vm_id': 'vm-1009'}

Авторы

Pavan Bidkar (@pgbidkar)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/vmware/vmware_content_deploy_template_module.html