community.vmware.vmware_guest_cross_vc_clone – Клонирование ВМ/шаблона между центрами обработки данных
Примечание
Этот плагин входит в состав коллекции community.vmware (версия 1.7.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 строка | Идентификатор управляемого объекта (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, а ВМ существует, никаких действий не выполняется.Если установлено значение 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 словарь | всегда | метаданные о виртуальной машине Пример: {'datastore': '', 'host': '', 'power_on': '', 'vcenter': '', 'vm_folder': '', 'vm_name': ''} |
Авторы
- Anusha Hegde (@anusha94)
© 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_guest_cross_vc_clone_module.html
