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

Примечание

Этот модуль входит в коллекцию community.vmware (версия 6.2.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в состав ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить ее, используйте: ansible-galaxy collection install community.vmware. Для использования этого модуля необходимы дополнительные требования; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: community.vmware.vmware_content_deploy_template.

УСТАРЕЛО
Краткое описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

УСТАРЕЛО

Удалено в:: версии 7.0.0
Причина:: Этот модуль перенесен в новую коллекцию vmware.vmware
Альтернатива:: Вместо него используйте vmware.vmware.deploy_content_library_template.

Краткое описание

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

Требования

На узле, выполняющем этот модуль, необходимо следующее.

vSphere Automation SDK

Параметры

Параметр	Комментарии
cluster string	Имя кластера в центре обработки данных, в котором будет размещена развернутая виртуальная машина. Обязательный параметр, если не указан `resource_pool`.
datacenter string / обязательный	Имя центра обработки данных, в котором будет развернута виртуальная машина.
datastore string	Имя хранилища данных для виртуальной машины и диска. Обязательный параметр, если не указано `datastore_cluster`.
datastore_cluster string	Имя кластера хранилищ данных для виртуальной машины и диска. Убедитесь, что для рекомендуемого хранилища данных из указанного кластера включена функция Storage DRS. Если Storage DRS не включен, выбирается хранилище данных с наибольшим объемом свободного пространства. Обязательный параметр, если не указано `datastore`.
folder string	Имя папки в центре обработки данных, в которой будет размещена развернутая виртуальная машина. По умолчанию: `"vm"`
host string	Имя узла ESX в центре обработки данных, на котором будет размещена развернутая виртуальная машина. Узел должен входить в кластер, содержащий пул ресурсов. Требуется вместе с `resource_pool` для поиска сведений о пуле ресурсов. Этот параметр будет использоваться как дополнительная информация, если существуют пулы ресурсов с одинаковыми именами.
hostname string	Имя хоста или IP-адрес сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_HOST`.
library псевдонимы: content_library, content_library_src string	Имя библиотеки содержимого, в которой находится шаблон.
log_level string	Уровень ведения журнала для этого модуля. Варианты: `"debug"` `"info"` `"normal"` ← (по умолчанию)
name псевдоним: vm_name string / обязательный	Имя развертываемой виртуальной машины.
password псевдонимы: pass, pwd string	Пароль сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_PASSWORD`.
port integer	Номер порта сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_PORT`. По умолчанию: `443`
proxy_host string	Адрес прокси-сервера, который будет принимать и перенаправлять все HTTPS-запросы. Укажите имя хоста или IP-адрес. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_PROXY_HOST`.
proxy_port integer	Порт HTTP-прокси-сервера, который будет принимать и перенаправлять все HTTPS-запросы. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_PROXY_PORT`.
proxy_protocol псевдоним: protocol string	Используемый протокол подключения к прокси-серверу. Этот параметр используется, если правильный протокол прокси-сервера невозможно определить автоматически. Варианты: `"http"` `"https"` ← (по умолчанию)
resource_pool string	Имя пула ресурсов в центре обработки данных, в котором будет размещена развернутая виртуальная машина. Обязательный параметр, если не указан `cluster`. Для пула ресурсов с именем по умолчанию или неуникальным именем укажите `host` и `cluster`. `Resources` — имя пула ресурсов по умолчанию.
state string	Состояние виртуальной машины, развернутой из шаблона в библиотеке содержимого. Если задано `present` и виртуальная машина не существует, она создается. Если задано `present` и виртуальная машина существует, никаких действий не выполняется. Если задано `poweredon` и виртуальная машина не существует, она создается и включается. Если задано `poweredon` и виртуальная машина существует, никаких действий не выполняется. Варианты: `"present"` ← (по умолчанию) `"poweredon"`
template псевдоним: template_src string / обязательный	Имя шаблона, на основе которого будет развернута виртуальная машина.
username псевдонимы: admin, user string	Имя пользователя сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_USER`.
validate_certs boolean	Разрешает подключение, если SSL-сертификаты недействительны. Установите значение `false`, если сертификаты не являются доверенными. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Для всех модулей требуется право на запись через API, поэтому они не поддерживаются бесплатной лицензией ESXi.
Все переменные и имена объектов VMware чувствительны к регистру.
Модулям может требоваться библиотека Python ‘requests’, которая по умолчанию не использует системное хранилище сертификатов. Можно указать хранилище сертификатов, задав переменную окружения REQUESTS_CA_BUNDLE. Обратите внимание: наличие этой переменной может в некоторых случаях привести к игнорированию значения ‘false’ параметра ‘validate_certs’. Пример: ‘export REQUESTS_CA_BUNDLE=/path/to/your/ca_bundle.pem’

Примеры

- 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 dictionary	Сообщение о развертывании виртуальной машины и vm_id Возвращается: при успешном выполнении Пример: `{"msg": "Deployed Virtual Machine 'Sample_VM'.", "vm_id": "vm-1009"}`

Статус

Этот модуль будет удален в версии 7.0.0. [устарело]
Дополнительные сведения см. в разделе УСТАРЕЛО.

Авторы

Pavan Bidkar (@pgbidkar)

Ссылки на коллекцию

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