community.vmware.vmware_tools – Выполнение задач внутри ВМ с помощью VMware Tools
Примечание
Этот плагин входит в состав коллекции community.vmware (версия 1.7.0).
Для его установки используйте: ansible-galaxy collection install community.vmware.
Для использования в плейбуке укажите: community.vmware.vmware_tools.
Описание
- Используйте VMware Tools для запуска задач в гостевой операционной системе, работающей в инфраструктуре VMware, или для передачи/получения файлов.
- В случае с Windows ВМ, установите
ansible_shell_typeнаpowershell. - Не работает с «become».
Требования
Ниже перечислены требования к локальному узлу контроллера, на котором выполняется данное подключение.
- pyvmomi (библиотека Python)
- requests (библиотека Python)
Параметры
| Параметр | Варианты/Значения по умолчанию | Конфигурация | Комментарии |
|---|---|---|---|
| exec_command_sleep_interval float | По умолчанию: 0.5 | var: ansible_vmware_tools_exec_command_sleep_interval | Время ожидания в секундах между выполнением команды. |
| executable строка | По умолчанию: "/bin/sh" | записи в ini: [defaults] env:ANSIBLE_EXECUTABLE var: ansible_executable var: ansible_vmware_tools_executable | оболочка для выполнения внутри контейнера |
| file_chunk_size целое число | По умолчанию: 128 | var: ansible_vmware_tools_file_chunk_size | Размер фрагмента файла. (Применимо при записи файла на диск, например, с использованием модуля fetch.) |
| validate_certs булево |
| env:VMWARE_VALIDATE_CERTS var: ansible_vmware_validate_certs | Проверка SSL для подключения. Примечание: Это позволит проверить сертификаты как для vmware_host, так и для хоста ESXi, на котором работает ВМ. |
| vm_password строка / обязательно | var: ansible_password var: ansible_vmware_tools_password | Пароль пользователя в гостевой операционной системе. | |
| vm_path строка / обязательно | var: ansible_vmware_guest_path | Путь к ВМ, абсолютный относительно подключения. Пример vCenter: Datacenter/vm/Discovered virtual machine/testVM.Пример хоста ESXi: ha-datacenter/vm/testVM.Должен включать имя ВМ, добавленное к «каталогу», как это передаётся в community.vmware.vmware_guest. Необходимо включить vm между центром данных и остальной частью пути к ВМ. Значение по умолчанию для центра данных на сервере ESXi — ha-datacenter.Папка vm не отображается в веб-клиенте vSphere, но необходима для работы API VMware. | |
| vm_user строка / обязательно | var: ansible_user var: ansible_vmware_tools_user | Имя пользователя ВМ. | |
| vmware_host строка / обязательно | env:VI_SERVER env:VMWARE_HOST var: ansible_host var: ansible_vmware_host | FQDN или IP-адрес для подключения (vCenter или ESXi-хост). | |
| vmware_password строка / обязательно | env:VI_PASSWORD env:VMWARE_PASSWORD var: ansible_vmware_password | Пароль для подключения. | |
| vmware_port строка | По умолчанию: 443 | env:VI_PORTNUMBER env:VMWARE_PORT var: ansible_port var: ansible_vmware_port | Порт для подключения. |
| vmware_user строка / обязательно | env:VI_USERNAME env:VMWARE_USER var: ansible_vmware_user | Имя пользователя для подключения. Требуются следующие разрешения для ВМ: - VirtualMachine.GuestOperations.Execute - VirtualMachine.GuestOperations.Modify - VirtualMachine.GuestOperations.Query |
Авторы
- Deric Crago <deric.crago@gmail.com>
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/vmware/vmware_tools_connection.html
