Spec-Zone.ru › Ansible

community.vmware.vmware_vmotion модуль — Перемещение виртуальной машины с помощью vMotion и/или ее vmdk с помощью storage vMotion.

Примечание

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

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

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

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

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

Обзор

  • Используя VMware vCenter, переместить виртуальную машину с помощью vMotion на другой хост и/или ее vmdk на другой хранилище данных с помощью storage vMotion.

Параметры

Параметр

Комментарии

destination_cluster

строка

Имя целевого кластера, на котором должна работать виртуальная машина.

Работает только при включенном DRS для данного кластера.

destination_datacenter

строка

Имя целевого дата-центра, на котором находится хранилище данных.

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

destination_datastore

псевдонимы: datastore

строка

Имя целевого хранилища данных, на котором должен быть перемещен файл vmdk виртуальной машины.

destination_datastore_cluster

строка

Имя целевого кластера хранилищ данных (хранилище данных) для перемещения файла vmdk виртуальной машины.

Работает только при включенном DRS для кластера, на котором запущена или должна работать виртуальная машина.

destination_host

псевдонимы: destination

строка

Имя целевого хоста, на котором должна работать виртуальная машина.

Начиная с версии 2.6, этот параметр необязателен, в отличие от предыдущих версий.

destination_resourcepool

псевдонимы: resource_pool

строка

Имя целевого пула ресурсов, в котором должна работать виртуальная машина.

Пул ресурсов требуется, если vmotion выполняется между хостами, которые входят в разные кластеры или дата-центры.

Если не указан, объект resource_pool будет получен из родительского объекта host_obj.

hostname

строка

Имя хоста или IP-адрес сервера vCenter vSphere или ESXi.

Если значение не указано в задаче, вместо него будет использовано значение переменной среды VMWARE_HOST.

moid

строка

Идентификатор управляемого объекта экземпляра для управления, если он известен. Это уникальный идентификатор только в пределах одного экземпляра vCenter.

Требуется, если vm_name или vm_uuid не указаны.

password

псевдонимы: pass, pwd

строка

Пароль сервера vCenter vSphere или ESXi.

Если значение не указано в задаче, вместо него будет использовано значение переменной среды VMWARE_PASSWORD.

port

целое число

Номер порта сервера vCenter vSphere или ESXi.

Если значение не указано в задаче, вместо него будет использовано значение переменной среды VMWARE_PORT.

По умолчанию: 443

proxy_host

строка

Адрес прокси-сервера, который будет принимать все запросы HTTPS и перенаправлять их.

Формат — имя хоста или IP-адрес.

Если значение не указано в задаче, вместо него будет использовано значение переменной среды VMWARE_PROXY_HOST.

proxy_port

целое число

Порт HTTP-прокси, который будет принимать все запросы HTTPS и перенаправлять их.

Если значение не указано в задаче, вместо него будет использовано значение переменной среды VMWARE_PROXY_PORT.

timeout

целое число

добавлен в community.vmware 3.4.0

Время ожидания в секундах. При достижении времени ожидания модуль завершит работу с ошибкой.

По умолчанию: 3600

use_instance_uuid

логическое

Использовать UUID экземпляра VMware вместо UUID BIOS.

Варианты:

  • false ← (по умолчанию)
  • true

username

псевдонимы: admin, user

строка

Имя пользователя сервера vCenter vSphere или ESXi.

Если значение не указано в задаче, вместо него будет использовано значение переменной среды VMWARE_USER.

validate_certs

логическое

Разрешить подключение, когда сертификаты SSL недействительны. Установить в false при недоверии к сертификатам.

Если значение не указано в задаче, вместо него будет использовано значение переменной среды VMWARE_VALIDATE_CERTS.

Варианты:

  • false
  • true ← (по умолчанию)

vm_name

aliases: vm

string

Имя виртуальной машины для выполнения vMotion.

Этот параметр обязателен, если vm_uuid не задан.

vm_uuid

aliases: uuid

string

UUID виртуальной машины, для которой выполняется операция vMotion.

Этот параметр обязателен, если vm_name или moid не заданы.

Примечания

Примечание

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

Примеры

- name: Perform vMotion of virtual machine
  community.vmware.vmware_vmotion:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    vm_name: 'vm_name_as_per_vcenter'
    destination_host: 'destination_host_as_per_vcenter'
  delegate_to: localhost

- name: Perform vMotion of virtual machine
  community.vmware.vmware_vmotion:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    moid: vm-42
    destination_host: 'destination_host_as_per_vcenter'
  delegate_to: localhost

- name: Perform vMotion of virtual machine to resource_pool
  community.vmware.vmware_vmotion:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    moid: vm-42
    destination_host: 'destination_host_as_per_vcenter'
    destination_resourcepool: 'destination_resourcepool_as_per_vcenter'
  delegate_to: localhost

- name: Perform storage vMotion of virtual machine
  community.vmware.vmware_vmotion:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    vm_name: 'vm_name_as_per_vcenter'
    destination_datastore: 'destination_datastore_as_per_vcenter'
  delegate_to: localhost

- name: Perform storage vMotion and host vMotion of virtual machine
  community.vmware.vmware_vmotion:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    vm_name: 'vm_name_as_per_vcenter'
    destination_host: 'destination_host_as_per_vcenter'
    destination_datastore: 'destination_datastore_as_per_vcenter'
  delegate_to: localhost

- name: Perform storage vMotion to a Storage Cluster and vMotion to a Cluster of virtual machine
  community.vmware.vmware_vmotion:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    vm_name: 'vm_name_as_per_vcenter'
    destination_cluster: 'destination_cluster_as_per_vcenter'
    destination_datastore_cluster: 'destination_datastore_cluster_as_per_vcenter'
  delegate_to: localhost

Значения возврата

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

Ключ

Описание

datastore

string

Список хранилищ данных, на которых находится виртуальная машина.

Возвращается только если запрошен Storage vMotion (хранилище данных или кластер хранилищ данных).

Возвращается: changed или success

Пример: "datastore1"

running_host

string

Список хостов, к которым зарегистрирована виртуальная машина.

Возвращается только если запрошен vMotion (кластер или хост).

Возвращается: changed или success

Пример: "host1.example.com"

Авторы

  • Bede Carroll (@bedecarroll)
  • Olivier Boukili (@oboukili)

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

  • Отслеживание проблем
  • Главная страница
  • Репозиторий (исходный код)

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API