Соединение community.vmware.vmware_tools — выполнение задач в виртуальной машине с помощью VMware Tools

Примечание

Этот плагин соединения входит в коллекцию community.vmware (версия 6.2.0).

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

Для установки используйте: ansible-galaxy collection install community.vmware. Для использования этого плагина соединения требуются дополнительные зависимости; подробности см. в разделе Требования.

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

Краткое описание
Требования
Параметры

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

Используйте VMware Tools для выполнения задач в гостевых операционных системах, работающих в инфраструктуре VMware, а также для передачи файлов в них и из них.
Для виртуальных машин Windows установите ansible_shell_type в значение powershell.
Не работает с become.

Требования

Следующие требования должны выполняться на локальном узле контроллера, который использует это соединение.

requests (библиотека Python)

Параметры

Параметр	Описание
exec_command_sleep_interval float	Время ожидания в секундах между выполнениями команд. По умолчанию: `0.5` Конфигурация: Переменная: ansible_vmware_tools_exec_command_sleep_interval
executable string	Оболочка для выполнения команд в контейнере По умолчанию: `"/bin/sh"` Конфигурация: Запись INI: [defaults] executable = /bin/sh Переменная окружения: `ANSIBLE_EXECUTABLE` Переменная: ansible_executable Переменная: ansible_vmware_tools_executable
file_chunk_size integer	Размер фрагмента файла. (Применяется при записи файла на диск, например при использовании модуля ansible.builtin.fetch.) По умолчанию: `128` Конфигурация: Переменная: ansible_vmware_tools_file_chunk_size
validate_certs boolean	Проверять SSL-сертификат соединения. Примечание: сертификаты будут проверяться как для `vmware_host`, так и для хоста ESXi, на котором работает виртуальная машина. Варианты: `false` `true` ← (по умолчанию) Конфигурация: Переменная окружения: `VMWARE_VALIDATE_CERTS` Переменная: ansible_vmware_validate_certs
vm_password string / обязательный	Пароль пользователя в гостевой операционной системе. Конфигурация: Переменная: ansible_password Переменная: ansible_vmware_tools_password
vm_path string	Взаимоисключающий параметр с `vm_uuid` Абсолютный путь к виртуальной машине для соединения. Пример для vCenter: `Datacenter/vm/Discovered virtual machine/testVM`. Пример для хоста ESXi: `ha-datacenter/vm/testVM`. Путь должен включать имя виртуальной машины, добавленное к «folder», как при передаче параметру community.vmware.vmware_guest. Между центром обработки данных и остальной частью пути к виртуальной машине необходимо указать vm. Значение центра обработки данных по умолчанию для сервера ESXi — `ha-datacenter`. Папка vm не отображается в веб-клиенте vSphere, но необходима для работы VMware API. Конфигурация: Переменная: ansible_vmware_guest_path
vm_user string / обязательный	Имя пользователя виртуальной машины. Для подключения к виртуальной машине используется `ansible_vmware_tools_user`. Ansible использует `ansible_user` на виртуальной машине. Конфигурация: Переменная: ansible_user Переменная: ansible_vmware_tools_user
vm_uuid string	UUID виртуальной машины Взаимоисключающий параметр с `vm_path` Конфигурация: Переменная: ansible_vmware_guest_uuid
vmware_host string / обязательный	FQDN или IP-адрес для соединения (vCenter или хост ESXi). Конфигурация: Переменная окружения: `VI_SERVER` Переменная окружения: `VMWARE_HOST` Переменная: ansible_host Переменная: ansible_vmware_host
vmware_password string / обязательный	Пароль для соединения. Конфигурация: Переменная окружения: `VI_PASSWORD` Переменная окружения: `VMWARE_PASSWORD` Переменная: ansible_vmware_password
vmware_port string	Порт для соединения. По умолчанию: `443` Конфигурация: Переменная окружения: `VI_PORTNUMBER` Переменная окружения: `VMWARE_PORT` Переменная: ansible_port Переменная: ansible_vmware_port
vmware_user string / обязательный	Имя пользователя для соединения. Для виртуальной машины требуются следующие разрешения: - VirtualMachine.GuestOperations.Execute - VirtualMachine.GuestOperations.Modify - VirtualMachine.GuestOperations.Query Конфигурация: Переменная окружения: `VI_USERNAME` Переменная окружения: `VMWARE_USER` Переменная: ansible_vmware_user

Примечание

Для записей каждого типа (переменная Ansible, переменная окружения и т. д.), перечисленных выше, задан порядок приоритета от низкого к высокому. Например, переменная, расположенная ниже в списке, переопределяет переменную, расположенную выше. Типы записей также упорядочены по приоритету от низкого к высокому. Например, запись ansible.cfg (расположенная выше в списке) переопределяется переменной Ansible (расположенной ниже в списке).

Авторы

Deric Crago (@dericcrago)

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

© 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/vmware_tools_connection.html