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

Примечание

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

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

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

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

Обзор

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
destination_datastore строка / обязательно		Имя целевого хранилища данных или кластера хранилищ данных. Если указано имя кластера хранилищ данных, мы найдем рекомендуемое хранилище данных Storage DRS в этом кластере.
destination_host строка / обязательно		Имя целевого хоста.
destination_resource_pool строка		Целевой пул ресурсов. Если не указан, будет использоваться родительский пул ресурсов целевого хоста.
destination_vcenter строка / обязательно		Имя хоста или IP-адрес целевого VCenter.
destination_vcenter_password строка / обязательно		Пароль целевого VCenter.
destination_vcenter_port целое число	По умолчанию: 443	Порт для подключения к целевому VCenter.
destination_vcenter_username строка / обязательно		Имя пользователя целевого VCenter.
destination_vcenter_validate_certs булево	Варианты: нет ← да	Параметр, указывающий, нужно ли проверять сертификаты целевого VCenter.
destination_vm_folder строка / обязательно		Целевой каталог, абсолютный путь для развертывания клонированной ВМ. Этот параметр чувствителен к регистру. Примеры: каталог: vm каталог: ha-datacenter/vm каталог: /datacenter1/vm
destination_vm_name строка / обязательно		Имя клонированной ВМ.
hostname строка		Имя хоста или IP-адрес сервера vSphere vCenter или ESXi. Если значение не указано в задании, используется значение переменной среды `VMWARE_HOST`. Поддержка переменных окружения добавлена в Ansible 2.6.
moid строка		Идентификатор управляемого объекта ВМ/шаблона для управления, если известен. Это уникальный идентификатор только в пределах одного экземпляра VCenter. Требуется, если `name` или `uuid` не указаны.
name строка		Имя виртуальной машины или шаблона. Обязательный параметр, если параметр `uuid` или `moid` не указан.
password строка		Пароль сервера vSphere vCenter или ESXi. Если значение не указано в задании, используется значение переменной среды `VMWARE_PASSWORD`. Поддержка переменных окружения добавлена в Ansible 2.6. псевдонимы: pass, pwd
port целое число	По умолчанию: 443	Номер порта сервера vSphere vCenter или ESXi. Если значение не указано в задании, используется значение переменной среды `VMWARE_PORT`. Поддержка переменных окружения добавлена в Ansible 2.6.
proxy_host строка		Адрес прокси-сервера, который будет принимать все запросы HTTPS и перенаправлять их. Формат — имя хоста или IP-адрес. Если значение не указано в задании, используется значение переменной среды `VMWARE_PROXY_HOST`. Эта функция зависит от версии pyvmomi, большей чем v6.7.1.2018.12
proxy_port целое число		Порт HTTP-прокси-сервера, который будет принимать все запросы HTTPS и перенаправлять их. Если значение не указано в задании, используется значение переменной среды `VMWARE_PROXY_PORT`.
state строка	Варианты: present ← включено	Состояние развернутой виртуальной машины. Если установлено значение `present` и ВМ не существует, то ВМ создается. Если установлено значение `present` и ВМ существует, никаких действий не предпринимается. Если установлено значение `poweredon` и ВМ не существует, то ВМ создается в включенном состоянии. Если установлено значение `poweredon` и ВМ существует, никаких действий не предпринимается.
use_instance_uuid булево	Варианты: нет ← да	Использовать ли UUID экземпляра VMware вместо UUID BIOS.
username строка		Имя пользователя сервера vSphere vCenter или ESXi. Если значение не указано в задании, используется значение переменной среды `VMWARE_USER`. Поддержка переменных окружения добавлена в Ansible 2.6. псевдонимы: admin, user
uuid строка		UUID экземпляра ВМ/шаблона для клонирования, это уникальный идентификатор VMware. Требуется, если параметр `name` или `moid` не указан.
validate_certs булево	Варианты: нет да ←	Разрешает подключение, когда SSL-сертификаты не валидны. Установите значение `false`, когда сертификаты не доверяются. Если значение не указано в задании, используется значение переменной среды `VMWARE_VALIDATE_CERTS`. Поддержка переменных окружения добавлена в Ansible 2.6. Если установлено значение `true`, убедитесь, что на данном компьютере установлен Python >= 2.7.9.

Примеры

# 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 словарь	всегда	метаданные о виртуальной машине Пример: {'хранилище': '', 'хост': '', 'включена': '', 'vcenter': '', 'каталог_вм': '', 'имя_вм': ''}

Авторы

Anusha Hegde (@anusha94)

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