vmware_vm_shell - Выполнение команд в гостевой операционной системе VMware
Новая версия 2.1.
Обзор
- Модуль позволяет пользователю запускать общие системные административные команды в гостевой операционной системе.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- python >= 2.6
- PyVmomi
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| cluster | Кластер, на котором размещена виртуальная машина. Если задано, это поможет ускорить поиск виртуальной машины. | |
| datacenter | Центр обработки данных, на котором размещена виртуальная машина. Если задано, это поможет ускорить поиск виртуальной машины. | |
| folder (добавлено в 2.4) | Значение по умолчанию: "/vm" | Папка назначения, абсолютный или относительный путь для поиска существующей гостевой или создания новой. Папка должна содержать центр обработки данных. Центр обработки данных ESX - ha-datacenter Примеры: 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 |
| Разрешает подключение, когда сертификаты SSL недействительны. Установите значение false когда сертификаты не доверяются.Если значение не указано в задании, вместо него используется значение переменной среды VMWARE_VALIDATE_CERTS. Поддержка переменных среды добавлена в версии 2.6. Если установлено значение yes, убедитесь, что на данном компьютере установлен Python >= 2.7.9. |
| vm_id обязательно | Имя виртуальной машины, с которой нужно работать. | |
| vm_id_type |
| Метод идентификации VMware, с помощью которого будет идентифицироваться виртуальная машина. |
| vm_password обязательно | Пароль, используемый для входа в виртуальную машину. | |
| vm_shell обязательно | Абсолютный путь к программе, которую нужно запустить. В Linux оболочка запускается через bash. | |
| vm_shell_args | Значение по умолчанию: " " | Аргумент для программы. |
| vm_shell_cwd | Текущая рабочая директория приложения, из которой она будет запущена. | |
| vm_shell_env | Список переменных окружения, разделенных запятыми, в формате гостевой ОС. | |
| vm_username обязательно | Имя пользователя для входа в виртуальную машину. |
Примечания
Примечание
- Проверено на vSphere 5.5
- Используется только первое соответствие vm_id, даже если есть несколько совпадений
Примеры
- name: Run command inside a vm
vmware_vm_shell:
hostname: myVSphere
username: myUsername
password: mySecret
datacenter: myDatacenter
folder: /vm
vm_id: NameOfVM
vm_username: root
vm_password: superSecret
vm_shell: /bin/echo
vm_shell_args: " $var >> myFile "
vm_shell_env:
- "PATH=/bin"
- "VAR=test"
vm_shell_cwd: "/tmp"
delegate_to: localhost
register: shell_command_output
Статус
Этот модуль помечен как предварительный, что означает, что его интерфейс не гарантируется как обратной совместимый.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Дополнительная информация приведена в Поддержка и техническое обслуживание модулей.
Список других модулей, поддерживаемых сообществом Ansible, см. в здесь.
Автор
- Ritesh Khadgaray (@ritzk)
- Abhijeet Kasurde (@Akasurde)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 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_vm_shell_module.html
