vmware_guest_tools_wait - Ожидание готовности инструментов VMware
Новая версия 2.4.
Обзор
- Этот модуль может использоваться для ожидания готовности инструментов VMware на указанной виртуальной машине и возвращения фактов.
Требования
Ниже приведены требования к хосту, на котором выполняется этот модуль.
- python >= 2.6
- PyVmomi
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| folder | Папка назначения, абсолютный или относительный путь для поиска существующей виртуальной машины. Требуется только в том случае, если найдено несколько виртуальных машин с одинаковым name.Папка должна включать дата-центр. Дата-центр 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 | |
| hostname str | Имя хоста или IP-адрес сервера vCenter или ESXi. Если значение не указано в задаче, используется значение переменной окружения VMWARE_HOST.Поддержка переменных окружения добавлена в версии 2.6. | |
| name | Имя виртуальной машины, для которой нужно дождаться готовности инструментов. Требуется, если uuid не указан. | |
| name_match |
| Если несколько виртуальных машин соответствуют имени, используется первая или последняя найденная. |
| password str | Пароль сервера vCenter или ESXi. Если значение не указано в задаче, используется значение переменной окружения VMWARE_PASSWORD.Поддержка переменных окружения добавлена в версии 2.6. Псевдонимы: pass, pwd | |
| port int (добавлено в 2.5) | Значение по умолчанию: 443 | Номер порта сервера vCenter или ESXi. Если значение не указано в задаче, используется значение переменной окружения VMWARE_PORT.Поддержка переменных окружения добавлена в версии 2.6. |
| username str | Имя пользователя сервера vCenter или ESXi. Если значение не указано в задаче, используется значение переменной окружения VMWARE_USER.Поддержка переменных окружения добавлена в версии 2.6. Псевдонимы: admin, user | |
| uuid | UUID виртуальной машины, для которой нужно дождаться готовности инструментов, если известен. Это уникальный идентификатор VMware. Требуется, если name не указан. | |
| validate_certs bool |
| Разрешает подключение, когда сертификаты SSL недействительны. Установите в false при недоверенных сертификатах.Если значение не указано в задаче, используется значение переменной окружения VMWARE_VALIDATE_CERTS.Поддержка переменных окружения добавлена в версии 2.6. Если установлено в yes, убедитесь, что на данном компьютере установлен Python >= 2.7.9. |
Примечания
Примечание
- Тестировано на vSphere 6.5
Примеры
- name: Wait for VMware tools to become available by UUID
vmware_guest_tools_wait:
hostname: 192.168.1.209
username: administrator@vsphere.local
password: vmware
validate_certs: no
uuid: 421e4592-c069-924d-ce20-7e7533fab926
delegate_to: localhost
register: facts
- name: Wait for VMware tools to become available by name
vmware_guest_tools_wait:
hostname: 192.168.1.209
username: administrator@vsphere.local
password: vmware
validate_certs: no
name: test-vm
folder: /datacenter1/vm
delegate_to: localhost
register: facts
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращенное значение | Описание |
|---|---|---|
| instance dict | всегда | метаданные о виртуальной машине Пример: None |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратная совместимость.
Обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Дополнительную информацию см. в разделе Техническое обслуживание и поддержка модулей.
Список других модулей, которые также поддерживаются сообществом Ansible, см. здесь.
Автор
- Philippe Dellaert (@pdellaert) <philippe@dellaert.org>
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 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_tools_wait_module.html