community.vmware.vmware_deploy_ovf – Развёртывает виртуальную машину VMware из файла OVF или OVA

Примечание

Этот плагин входит в коллекцию community.vmware (версия 1.7.0).

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

Для использования в книге задач укажите: community.vmware.vmware_deploy_ovf.

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

Обзор

Этот модуль может использоваться для развертывания виртуальной машины VMware из файла OVF или OVA

Требования

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

pyvmomi

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
allow_duplicates boolean	Варианты: нет да Значение по умолчанию: "True"	Разрешить дублирование имён ВМ. ESXi позволяет дублирование, vCenter, возможно, нет.
cluster string		Кластер, в который необходимо развернуть.
datacenter string	Значение по умолчанию: "ha-datacenter"	Центр обработки данных, в который необходимо развернуть.
datastore string	Значение по умолчанию: "datastore1"	Хранилище данных, в которое необходимо развернуть.
deployment_option string		Ключ выбранного варианта развертывания.
disk_provisioning string	Варианты: flat eagerZeroedThick monolithicSparse twoGbMaxExtentSparse twoGbMaxExtentFlat thin ← sparse thick seSparse monolithicFlat	Тип подготовки диска.
fail_on_spec_warnings boolean	Варианты: нет ← да	Принудительно обрабатывать предупреждения OVF Import Spec как ошибки.
folder string		Абсолютный путь к папке, в которую необходимо поместить виртуальную машину. Если не указано, по умолчанию используется значение `datacenter.vmFolder`. Примеры: folder: /ha-datacenter/vm folder: ha-datacenter/vm folder: /datacenter1/vm folder: datacenter1/vm folder: /datacenter1/vm/folder1 folder: datacenter1/vm/folder1 folder: /folder1/datacenter1/vm folder: folder1/datacenter1/vm folder: /folder1/datacenter1/vm/folder2
hostname string		Имя хоста или IP-адрес сервера vSphere vCenter или ESXi. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_HOST`. Поддержка переменных среды добавлена в Ansible 2.6.
inject_ovf_env boolean	Варианты: нет ← да	Принудительно вставить заданные свойства в среду OVF и внедрить их через VMware Tools.
name string		Имя ВМ для работы. Имена виртуальных машин в vCenter не обязательно уникальны, что может быть проблематично.
networks dictionary	Значение по умолчанию: {"VM Network": "VM Network"}	Сопоставление имени сети OVF с именем сети vCenter.
ovf path		Путь к файлу OVF или OVA для развертывания. псевдонимы: ova
password string		Пароль сервера vSphere vCenter или ESXi. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_PASSWORD`. Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: pass, pwd
port integer	Значение по умолчанию: 443	Номер порта сервера vSphere vCenter или ESXi. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_PORT`. Поддержка переменных среды добавлена в Ansible 2.6.
power_on boolean	Варианты: нет да ←	Включить виртуальную машину после создания.
properties dictionary		Сопоставление значений свойств, найденных в OVF, в виде пар "ключ-значение".
proxy_host string		Адрес прокси-сервера, который будет получать все запросы HTTPS и перенаправлять их. Формат - имя хоста или IP-адрес. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_PROXY_HOST`. Эта функция зависит от версии pyvmomi, большей, чем v6.7.1.2018.12
proxy_port integer		Порт HTTP-прокси-сервера, который будет получать все запросы HTTPS и перенаправлять их. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_PROXY_PORT`.
resource_pool string	Значение по умолчанию: "Resources"	Пул ресурсов для развертывания.
username string		Имя пользователя сервера vSphere vCenter или ESXi. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_USER`. Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: admin, user
validate_certs boolean	Варианты: нет да ←	Разрешает подключение, когда сертификаты SSL недействительны. Установите в `false`, если сертификаты не доверяются. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_VALIDATE_CERTS`. Поддержка переменных среды добавлена в Ansible 2.6. Если установлено в `true`, убедитесь, что на данном компьютере установлен Python >= 2.7.9.
wait boolean	Варианты: нет да ←	Ожидать включения хоста.
wait_for_ip_address boolean	Варианты: нет ← да	Ожидать, пока vCenter не обнаружит IP-адрес для ВМ. Для правильной работы после создания требуется vmware-tools (vmtoolsd).

Примеры

- community.vmware.vmware_deploy_ovf:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    ovf: /path/to/ubuntu-16.04-amd64.ovf
    wait_for_ip_address: true
  delegate_to: localhost

# Deploys a new VM named 'NewVM' in specific datacenter/cluster, with network mapping taken from variable and using ova template from an absolute path
- community.vmware.vmware_deploy_ovf:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    datacenter: Datacenter1
    cluster: Cluster1
    datastore: vsandatastore
    name: NewVM
    networks: "{u'VM Network':u'{{ ProvisioningNetworkLabel }}'}"
    power_on: no
    ovf: /absolute/path/to/template/mytemplate.ova
  delegate_to: localhost

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

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

Ключ	Возвращаемое значение	Описание
instance dictionary	всегда	метаданные о новой виртуальной машине Пример: None

Авторы

Matt Martz (@sivel)

© 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_deploy_ovf_module.html