модуль community.vmware.vmware_guest_cross_vc_clone — клонирование ВМ/шаблона между vCenter

Примечание

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

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

Чтобы установить её, используйте: ansible-galaxy collection install community.vmware.

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

Краткое описание
Параметры
Примечания
Примеры
Возвращаемые значения

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

Этот модуль можно использовать для клонирования ВМ/шаблона между vCenter

Параметры

Параметр	Комментарии
destination_datastore string / обязательный	Имя целевого хранилища данных или кластера хранилищ данных. Если указано имя кластера хранилищ данных, в этом кластере будет найдено хранилище данных, рекомендованное Storage DRS.
destination_host string / обязательный	Имя целевого хоста.
destination_resource_pool string	Целевой пул ресурсов. Если параметр не указан, будет использоваться пул ресурсов родительского объекта целевого хоста.
destination_vcenter string / обязательный	Имя хоста или IP-адрес целевого VCenter.
destination_vcenter_password string / обязательный	Пароль целевого VCenter.
destination_vcenter_port integer	Порт для подключения к целевому VCenter. По умолчанию: `443`
destination_vcenter_username string / обязательный	Имя пользователя целевого VCenter.
destination_vcenter_validate_certs boolean	Параметр, указывающий, нужно ли выполнять проверку сертификатов целевого VCenter. Варианты: `false` ← (по умолчанию) `true`
destination_vm_folder string / обязательный	Целевая папка — абсолютный путь для развертывания клонированной ВМ. Примеры: folder: vm folder: ha-datacenter/vm folder: /datacenter1/vm
destination_vm_name string / обязательный	Имя клонированной ВМ.
hostname string	Имя хоста или IP-адрес сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_HOST`.
is_template boolean	Указывает, следует ли пометить новую виртуальную машину как шаблон. Варианты: `false` ← (по умолчанию) `true`
moid string	Идентификатор управляемого объекта (Managed Object ID) экземпляра ВМ/шаблона, которым нужно управлять, если он известен. Это уникальный идентификатор только в рамках одного экземпляра vCenter. Этот параметр обязателен, если не указаны `name` или `uuid`.
name string	Имя виртуальной машины или шаблона. Этот параметр обязателен, если не указаны `uuid` или `moid`.
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`.
state string	Состояние развернутой виртуальной машины. Если задано значение `present` и ВМ не существует, она будет создана. Если задано значение `present` и ВМ существует, никаких действий не выполняется. Если задано значение `poweredon` и ВМ не существует, она будет создана и включена. Если задано значение `poweredon` и ВМ существует, никаких действий не выполняется. Варианты: `"present"` ← (по умолчанию) `"poweredon"`
timeout integer добавлено в community.vmware 3.5.0	Время ожидания в секундах. По истечении этого времени модуль завершится с ошибкой. По умолчанию: `3600`
use_instance_uuid boolean	Использовать UUID экземпляра VMware вместо UUID BIOS. Варианты: `false` ← (по умолчанию) `true`
username псевдонимы: admin, user string	Имя пользователя сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_USER`.
uuid string	UUID экземпляра ВМ/шаблона, из которого выполняется клонирование; это уникальный идентификатор VMware. Этот параметр обязателен, если не указаны `name` или `moid`.
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’

Примеры

# Clone template
- name: clone a template across VC
  community.vmware.vmware_guest_cross_vc_clone:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    name: "test_vm1"
    destination_vm_name: "cloned_vm_from_template"
    destination_vcenter: '{{ destination_vcenter_hostname }}'
    destination_vcenter_username: '{{ destination_vcenter_username }}'
    destination_vcenter_password: '{{ destination_vcenter_password }}'
    destination_vcenter_port: '{{ destination_vcenter_port }}'
    destination_vcenter_validate_certs: '{{ destination_vcenter_validate_certs }}'
    destination_host: '{{ destination_esxi }}'
    destination_datastore: '{{ destination_datastore }}'
    destination_vm_folder: '{{ destination_vm_folder }}'
    state: present
  register: cross_vc_clone_from_template

- name: clone a VM across VC
  community.vmware.vmware_guest_cross_vc_clone:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: "{{ vcenter_password }}"
    name: "test_vm1"
    destination_vm_name: "cloned_vm_from_vm"
    destination_vcenter: '{{ destination_vcenter_hostname }}'
    destination_vcenter_username: '{{ destination_vcenter_username }}'
    destination_vcenter_password: '{{ destination_vcenter_password }}'
    destination_host: '{{ destination_esxi }}'
    destination_datastore: '{{ destination_datastore }}'
    destination_vm_folder: '{{ destination_vm_folder }}'
    state: poweredon
  register: cross_vc_clone_from_vm

- name: check_mode support
  community.vmware.vmware_guest_cross_vc_clone:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: "{{ vcenter_password }}"
    name: "test_vm1"
    destination_vm_name: "cloned_vm_from_vm"
    destination_vcenter: '{{ destination_vcenter_hostname }}'
    destination_vcenter_username: '{{ destination_vcenter_username }}'
    destination_vcenter_password: '{{ destination_vcenter_password }}'
    destination_host: '{{ destination_esxi }}'
    destination_datastore: '{{ destination_datastore }}'
    destination_vm_folder: '{{ destination_vm_folder }}'
  check_mode: true

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

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

Ключ	Описание
vm_info dictionary	метаданные виртуальной машины Возвращается: всегда Пример: `{"datastore": "", "host": "", "power_on": "", "vcenter": "", "vm_folder": "", "vm_name": ""}`

Авторы

Anusha Hegde (@anusha94)

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

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