vmware_guest_file_operation - Операции с файлами в гостевой ОС VMware без сети

Новое в версии 2.5.

Обзор
- Требования
Параметры
Примечания
Примеры
Статус
- Автор

Обзор

Модуль для копирования файла в ВМ, извлечения файла из ВМ и создания или удаления каталога в гостевой ОС.

Требования

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

python >= 2.6
PyVmomi
requests

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
cluster		Кластер, на котором размещена виртуальная машина. Если задано, это поможет ускорить поиск виртуальной машины.
copy		Копирование файла в ВМ без необходимости сети. Допустимые атрибуты: src: абсолютный или относительный путь к исходному файлу dest: путь назначения файла, путь должен существовать overwrite: False или True (необязательно, по умолчанию False)
datacenter		Центр обработки данных, содержащий виртуальную машину. Если задано, это поможет ускорить поиск виртуальной машины.
directory		Создание или удаление каталога. Допустимые атрибуты: path: путь к каталогу для создания или удаления operation: допустимые значения - create, delete recurse (boolean): Необязательно, по умолчанию (false)
fetch (добавлен в 2.5)		Получение файла из виртуальной машины без необходимости сети. Допустимые атрибуты: src: файл на удалённой системе для извлечения. Это должен быть файл, а не каталог dest: путь назначения файла на локальном компьютере, путь должен существовать
folder		Целевой каталог, абсолютный путь для поиска существующей гостевой машины или создания новой. Каталог должен содержать центр обработки данных. Центр обработки данных ESX - ha-datacenter Используется только если `vm_id_type` равно `inventory_path`. Примеры: folder: /ha-datacenter/vm folder: ha-datacenter/vm folder: /datacenter1/vm folder: datacenter1/vm folder: /datacenter1/vm/folder1 folder: datacenter1/vm/folder1 folder: /folder1/datacenter1/vm folder: folder1/datacenter1/vm folder: /folder1/datacenter1/vm/folder2 folder: vm/folder2 folder: folder2
hostname		Имя хоста или IP-адрес сервера vSphere vCenter или ESXi. Если значение не указано в задаче, используется значение переменной среды `VMWARE_HOST`. Поддержка переменных среды добавлена в версии 2.6.
password		Пароль сервера vSphere vCenter или ESXi. Если значение не указано в задаче, используется значение переменной среды `VMWARE_PASSWORD`. Поддержка переменных среды добавлена в версии 2.6. псевдонимы: pass, pwd
port (добавлен в 2.5)	По умолчанию: 443	Номер порта сервера vSphere vCenter или ESXi. Если значение не указано в задаче, используется значение переменной среды `VMWARE_PORT`. Поддержка переменных среды добавлена в версии 2.6.
username		Имя пользователя сервера vSphere vCenter или ESXi. Если значение не указано в задаче, используется значение переменной среды `VMWARE_USER`. Поддержка переменных среды добавлена в версии 2.6. псевдонимы: user, admin
validate_certs	Варианты: no yes По умолчанию: True	Разрешает подключение, когда сертификаты SSL недействительны. Установите в `false`, когда сертификаты не доверяются. Если значение не указано в задаче, используется значение переменной среды `VMWARE_VALIDATE_CERTS`. Поддержка переменных среды добавлена в версии 2.6.
vm_id обязательно		Имя виртуальной машины, с которой необходимо работать.
vm_id_type	Варианты: uuid dns_name inventory_path vm_name ←	Метод идентификации VMware, с помощью которого будет идентифицироваться виртуальная машина.
vm_password обязательно		Пароль, используемый для входа в виртуальную машину.
vm_username обязательно		Имя пользователя для входа в виртуальную машину.

Примечания

Примечание

Проверено на vSphere 6
Используется только первое совпадение с vm_id, даже если есть несколько совпадений

Примеры

- name: Create directory inside a vm
  vmware_guest_file_operation:
    hostname: myVSphere
    username: myUsername
    password: mySecret
    datacenter: myDatacenter
    validate_certs: True
    vm_id: NameOfVM
    vm_username: root
    vm_password: superSecret
    directory:
      path: "/test"
      operation: create
      recurse: no
  delegate_to: localhost

- name: copy file to vm
  vmware_guest_file_operation:
    hostname: myVSphere
    username: myUsername
    password: mySecret
    datacenter: myDatacenter
    validate_certs: True
    vm_id: NameOfVM
    vm_username: root
    vm_password: superSecret
    copy:
        src: "files/test.zip"
        dest: "/root/test.zip"
        overwrite: False
  delegate_to: localhost

- name: fetch file from vm
  vmware_guest_file_operation:
    hostname: myVSphere
    username: myUsername
    password: mySecret
    datacenter: myDatacenter
    validate_certs: True
    vm_id: NameOfVM
    vm_username: root
    vm_password: superSecret
    fetch:
        src: "/root/test.zip"
        dest: "files/test.zip"
  delegate_to: localhost

Статус

Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется обратной совместимостью.

Автор

Stéphane Travassac (@stravassac)

Подсказка

Если вы обнаружите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/vmware_guest_file_operation_module.html