Модуль community.vmware.vsphere_copy — копирование файла в хранилище данных VMware

Примечание

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

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

Чтобы установить её, используйте: ansible-galaxy collection install community.vmware.

Чтобы использовать её в плейбуке, укажите: community.vmware.vsphere_copy.

Краткое описание
Параметры
Примечания
Примеры

Краткое описание

Загрузка файлов в хранилище данных VMware через REST API vCenter.

Параметры

Параметр	Описание
datacenter строка	Центр обработки данных на сервере vCenter, содержащий хранилище данных.
datastore строка / обязательный	Хранилище данных, в которое нужно загрузить файлы.
diskformat строка добавлено в community.vmware 4.2.0	Необязательный аргумент — задаёт формат диска для некоторых видов загрузки, например VMDK с оптимизацией потоковой передачи. Официальная документация отсутствует, но, судя по всему, для VMDK с оптимизацией потоковой передачи, загружаемых в хранилище vSAN, необходимо задать `StreamVmdk`. Задание этого параметра для файлов, не являющихся VMDK, может привести к неопределённому поведению и не поддерживается. Возможные значения: `"StreamVmdk"`
hostname строка	Имя хоста или IP-адрес сервера vCenter vSphere. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_HOST`.
password псевдонимы: pass, pwd строка	Пароль сервера vCenter vSphere. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_PASSWORD`.
path псевдоним: dest строка / обязательный	Файл, который нужно загрузить в хранилище данных.
port целое число	Номер порта сервера vCenter vSphere. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_PORT`. По умолчанию: `443`
proxy_host строка	Адрес прокси-сервера, который будет принимать и перенаправлять все HTTPS-запросы. В качестве значения указывается имя хоста или IP-адрес. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_PROXY_HOST`.
proxy_port целое число	Порт HTTP-прокси-сервера, который будет принимать и перенаправлять все HTTPS-запросы. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_PROXY_PORT`.
src псевдоним: name строка / обязательный	Файл, который нужно загрузить в vCenter.
timeout целое число	Время ожидания загрузки в хранилище данных, в секундах. По умолчанию: `10`
username псевдонимы: admin, user строка	Имя пользователя сервера vCenter vSphere. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_USER`.
validate_certs логическое значение	Разрешает подключение при недействительных SSL-сертификатах. Если сертификаты не являются доверенными, задайте значение `false`. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_VALIDATE_CERTS`. Возможные значения: `false` `true` ← (по умолчанию)

Примечания

Примечание

Этот модуль следует запускать в системе, которая может напрямую обращаться к vCenter или ESXi и содержит передаваемый файл. Это может быть обычный удалённый целевой узел; также его можно изменить, используя transport: local или delegate_to.
Для всех модулей необходим доступ на запись через API, поэтому они не поддерживаются бесплатной лицензией ESXi.
Все переменные и имена объектов VMware чувствительны к регистру.
Модули могут использовать библиотеку Python «requests», которая по умолчанию не обращается к системному хранилищу сертификатов. Указать хранилище сертификатов можно, задав переменную окружения REQUESTS_CA_BUNDLE. Обратите внимание: наличие этой переменной может в некоторых случаях привести к тому, что значение «false» параметра «validate_certs» будет проигнорировано. Пример: «export REQUESTS_CA_BUNDLE=/path/to/your/ca_bundle.pem»

Примеры

- name: Copy file to datastore using delegate_to
  community.vmware.vsphere_copy:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    src: /some/local/file
    datacenter: DC1 Someplace
    datastore: datastore1
    path: some/remote/file
  delegate_to: localhost

- name: Copy file to datastore when datacenter is inside folder called devel
  community.vmware.vsphere_copy:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    src: /some/local/file
    datacenter: devel/DC1
    datastore: datastore1
    path: some/remote/file
  delegate_to: localhost

- name: Copy file to datastore using other_system
  community.vmware.vsphere_copy:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    src: /other/local/file
    datacenter: DC2 Someplace
    datastore: datastore2
    path: other/remote/file
  delegate_to: other_system

- name: Copy file to datastore using other_system
  community.vmware.vsphere_copy:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    src: /other/local/streamOptimized.vmdk
    datacenter: DC2 Someplace
    datastore: datastore2
    path: disk_imports/streamOptimized.vmdk
    timeout: 360
    diskformat: StreamVmdk
  delegate_to: other_system

Авторы

Dag Wieers (@dagwieers)

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

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/vmware/vsphere_copy_module.html