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 str		Имя хоста или IP-адрес сервера vCenter или ESXi vSphere. Если значение не указано в задаче, используется значение переменной среды `VMWARE_HOST`. Поддержка переменных среды добавлена в версии 2.6.
password str		Пароль сервера vCenter или ESXi vSphere. Если значение не указано в задаче, используется значение переменной среды `VMWARE_PASSWORD`. Поддержка переменных среды добавлена в версии 2.6. Псевдонимы: pass, pwd
port int (добавлено в 2.5)	По умолчанию: 443	Номер порта сервера vCenter или ESXi vSphere. Если значение не указано в задаче, используется значение переменной среды `VMWARE_PORT`. Поддержка переменных среды добавлена в версии 2.6.
username str		Имя пользователя сервера vCenter или ESXi vSphere. Если значение не указано в задаче, используется значение переменной среды `VMWARE_USER`. Поддержка переменных среды добавлена в версии 2.6. Псевдонимы: admin, user
validate_certs bool	Варианты: no да ←	Разрешает подключение, когда сертификаты SSL недействительны. Установите в `false` , если сертификаты не проверены. Если значение не указано в задаче, используется значение переменной среды `VMWARE_VALIDATE_CERTS`. Поддержка переменных среды добавлена в версии 2.6. Если установлено значение `yes`, убедитесь, что на данном компьютере установлен Python >= 2.7.9.
vm_id обязательно		Имя виртуальной машины, с которой нужно работать.
vm_id_type	Варианты: uuid dns_name inventory_path имя_вм ←	Метод идентификации 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

Статус

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

Техническое обслуживание

Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Подробную информацию см. в разделе Техническое обслуживание и поддержка модулей.

Список других модулей, поддерживаемых сообществом Ansible, см. в разделе здесь.

Автор

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.6/modules/vmware_guest_file_operation_module.html