Модуль community.vmware.vmware_content_deploy_template — Развёртывание виртуальной машины из шаблона, хранящегося в библиотеке контента.
Примечание
Этот модуль является частью коллекции community.vmware (версия 4.7.1).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install community.vmware. Для использования этого модуля необходимы дополнительные требования. Подробности см. в разделе Требования.
Чтобы использовать его в книге задач, укажите: community.vmware.vmware_content_deploy_template.
Обзор
- Модуль для развертывания виртуальной машины из шаблона в библиотеке контента.
- Функция библиотеки контента представлена в версии vSphere 6.0.
- Функция шаблонов vmtx представлена в vSphere 67U1, а API для клонирования шаблонов из библиотеки контента — в 67U2.
- Этот модуль не работает с версиями vSphere, младше 67U2.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- vSphere Automation SDK
Параметры
Параметр | Комментарии |
|---|---|
cluster string | Имя кластера в центре обработки данных, в котором будет размещена развернутая виртуальная машина. Обязательно, если |
datacenter string / required | Имя центра обработки данных, где будет развернута виртуальная машина. |
datastore string | Имя хранилища данных для хранения развернутой виртуальной машины и диска. Обязательно, если |
datastore_cluster string | Имя кластера хранилища данных для хранения развернутой виртуальной машины и диска. Убедитесь, что Storage DRS активен для рекомендуемого хранилища данных из данного кластера хранилища данных. Если Storage DRS не включен, выбирается хранилище данных с наибольшим свободным пространством для хранения. Обязательно, если |
folder string | Имя папки в центре обработки данных, в котором будет размещена развернутая виртуальная машина. По умолчанию: |
host string | Имя хоста ESX в центре обработки данных, в котором будет размещена развернутая виртуальная машина. Хост должен быть членом кластера, содержащего пул ресурсов. Обязательно с |
hostname string | Имя хоста или IP-адрес сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использовано значение переменной среды |
library aliases: content_library, content_library_src string | Имя библиотеки контента, в которой находится шаблон. |
log_level string | Требуемый уровень ведения журнала в этом модуле. Варианты:
|
name aliases: vm_name string / required | Имя виртуальной машины, которая будет развернута. |
password aliases: pass, pwd string | Пароль сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использовано значение переменной среды |
port integer | Номер порта vSphere vCenter. Если значение не указано в задаче, вместо него будет использовано значение переменной среды По умолчанию: |
protocol string | Протокол подключения. Варианты:
|
proxy_host string | Адрес прокси-сервера, который будет принимать все запросы HTTPS и передавать их. Формат - имя хоста или IP-адрес. Если значение не указано в задаче, вместо него будет использовано значение переменной среды |
proxy_port integer | Порт прокси-сервера HTTP, который будет принимать все запросы HTTPS и передавать их. Если значение не указано в задаче, вместо него будет использовано значение переменной среды |
resource_pool string | |
state string | Состояние виртуальной машины, развернутой из шаблона в библиотеке контента. Если установлено в Если установлено в Если установлено в Если установлено в Варианты:
|
template aliases: template_src string / обязательно | Имя шаблона, из которого должна быть развернута ВМ. |
username aliases: admin, user string | Имя пользователя сервера vCenter vSphere. Если значение не указано в задаче, будет использовано значение переменной окружения |
validate_certs boolean | Разрешает подключение, когда сертификаты SSL недействительны. Установите значение Если значение не указано в задаче, будет использовано значение переменной окружения Варианты:
|
Примечания
Примечание
- Все модули требуют доступа к API для записи и поэтому не поддерживаются на бесплатной лицензии ESXi.
- Все переменные и имена объектов VMware чувствительны к регистру.
Примеры
- 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 Возвращается: при успехе Пример: |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/vmware/vmware_content_deploy_template_module.html
