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

Примечание

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

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

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

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

Описание

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

Требования

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

pyvmomi

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
allow_duplicates boolean	Варианты: no yes Значение по умолчанию: "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	Варианты: no ← yes	Заставить модуль рассматривать предупреждения 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-адрес сервера vCenter vSphere или ESXi. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_HOST`. Поддержка переменных окружения добавлена в Ansible 2.6.
inject_ovf_env boolean	Варианты: no ← yes	Принудительно вставить заданные свойства в среду OVF и внедрить их через VMware Tools.
name string		Имя ВМ для работы. Имена виртуальных машин в vCenter не обязательно уникальны, что может создать проблемы.
networks dictionary	Значение по умолчанию: {"VM Network": "VM Network"}	`key: value` Сопоставление имени сети OVF с именем сети vCenter.
ovf path		Путь к файлу OVF или OVA для развёртывания. псевдонимы: ova
password string		Пароль сервера vCenter vSphere или ESXi. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_PASSWORD`. Поддержка переменных окружения добавлена в Ansible 2.6. псевдонимы: pass, pwd
port integer	Значение по умолчанию: 443	Номер порта сервера vCenter vSphere или ESXi. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_PORT`. Поддержка переменных окружения добавлена в Ansible 2.6.
power_on boolean	Варианты: no yes ←	Включить виртуальную машину после создания.
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		Имя пользователя сервера vCenter vSphere или ESXi. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_USER`. Поддержка переменных окружения добавлена в Ansible 2.6. псевдонимы: admin, user
validate_certs boolean	Варианты: no yes ←	Разрешает подключение при невалидных сертификатах SSL. Установите значение `false`, когда сертификаты недостоверны. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_VALIDATE_CERTS`. Поддержка переменных окружения добавлена в Ansible 2.6. Если установлено значение `true`, убедитесь, что на данном компьютере установлен Python >= 2.7.9.
wait boolean	Варианты: no yes ←	Ожидать включения хоста.
wait_for_ip_address boolean	Варианты: no ← yes	Ожидать, пока 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/vmware/vmware_deploy_ovf_module.html