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

Примечание

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

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

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

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

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

Обзор

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

Параметры

Параметр	Комментарии
destination_datastore строка / обязательный	Имя целевого хранилища данных или кластера хранилищ данных. Если указано имя кластера хранилищ данных, мы найдём рекомендуемое хранилище данных Storage DRS в этом кластере.
destination_host строка / обязательный	Имя целевого хоста.
destination_resource_pool строка	Целевой пул ресурсов. Если не указан, будет использован родительский пул ресурсов целевого хоста.
destination_vcenter строка / обязательный	Имя хоста или IP-адрес целевого VCenter.
destination_vcenter_password строка / обязательный	Пароль целевого VCenter.
destination_vcenter_port целое число	Порт для подключения к целевому VCenter. По умолчанию: `443`
destination_vcenter_username строка / обязательный	Имя пользователя целевого VCenter.
destination_vcenter_validate_certs логическое значение	Параметр, указывающий, нужно ли выполнять проверку сертификатов на целевом VCenter. Варианты: `false` ← (по умолчанию) `true`
destination_vm_folder строка / обязательный	Целевой каталог, абсолютный путь для развертывания клонированной виртуальной машины. Примеры: каталог: vm каталог: ha-datacenter/vm каталог: /datacenter1/vm
destination_vm_name строка / обязательный	Имя клонированной виртуальной машины.
hostname строка	Имя хоста или IP-адрес сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_HOST` вместо него.
is_template логическое значение	Указывает, должна ли новая виртуальная машина быть помечена как шаблон. Варианты: `false` ← (по умолчанию) `true`
moid строка	Идентификатор управляемого объекта (Managed Object ID) виртуальной машины/шаблона для управления, если известен. Это уникальный идентификатор только в рамках одного экземпляра vCenter. Это требуется, если `name` или `uuid` не указаны.
name строка	Имя виртуальной машины или шаблона. Это обязательный параметр, если параметр `uuid` или `moid` не указан.
password псевдонимы: pass, pwd строка	Пароль сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PASSWORD` вместо него.
port целое число	Номер порта сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PORT` вместо него. По умолчанию: `443`
proxy_host строка	Адрес прокси-сервера, который будет получать все запросы HTTPS и перенаправлять их. Формат — имя хоста или IP-адрес. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PROXY_HOST` вместо него.
proxy_port целое число	Порт 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 aliases: admin, user string	Имя пользователя сервера vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_USER`.
uuid string	UUID экземпляра виртуальной машины/шаблона для клонирования, уникальный идентификатор VMware. Обязательный параметр, если параметры `name` или `moid` не указаны.
validate_certs boolean	Разрешает подключение, когда сертификаты SSL недействительны. Установите значение `false`, если сертификаты не надёжны. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_VALIDATE_CERTS`. Доступные значения: `false` `true` ← (по умолчанию)

Примечания

Примечание

Все модули требуют доступа к API для записи и поэтому не поддерживаются в бесплатной лицензии ESXi.
Все имена переменных и объектов VMware регистрозависимы.

Примеры

# 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 словарь	метаданные о виртуальной машине Возвращается: всегда Пример: `{"datastore": "", "host": "", "power_on": "", "vcenter": "", "vm_folder": "", "vm_name": ""}`

Авторы

Anusha Hegde (@anusha94)

Ссылки на сборку

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