Vmware Guest Tools Wait

5 min

Sinopse

Esse módulo pode ser usado para esperar que o VMWare tools esteja disponível em uma dada VM e retornar os facts.

Parâmetros

Parâmetro	Tipo	Escolhas \| Valor Padrão	Comentários
datacenter	string		O nome do datacenter para o qual coletar informações. Caso não seja fornecido, reunirá informações sobre todos os datacenters do VMware infra.
folder	string		Pasta de destino, caminho relativo ou absoluto para encontrar um guest existente. Esse parâmetro é requerido somente se multiplas VMs com o mesmo NAME forem encontradas. A pasta deve ser incluida no datacenter. ESX's datacenter é HA-DATACENTER. Exemplos: 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
moid	string		ID do objeto gerenciado da instância a ser gerenciado, se conhecido, é um identificador exclusivo apenas em uma única instância do vCenter. Requerido se uuid ou nome não for fornecido.
name	string		Nome do datastore que corresponda. Se fornecido, informações especificas dos datastores são retornadas
name_match	string	First Last	Caso haja várias VMs correspondentes ao nome, este parâmetro define se será utilizada a primeira ou a última encontrada.
timeout	interger	500	Duração máxima do período de espera
use_instance_uuid	boolean	False True	Se deve usar o UUID da instância do VMware em vez do UUID do BIOS.
validate_certs	boolean	False True	Permite a conexão quando os certificados SSL não são válidos. Definido para falsequando os certificados não são confiáveis.Se o valor não for especificado na tarefa, o valor da variável de ambiente VMWARE_VALIDATE_CERTS será usado em seu lugar. Se definido como true, certifique-se de que Python> = 2.7.9 esteja instalado na máquina fornecida
uuid	string		UUID da instância a ser gerenciada, se conhecido, é o UUID do BIOS da VMware por padrão.

Notas

Testado em vSphere 7.0.2
Todos os módulos requerem acesso de gravação API e, portanto, não são suportados em uma licença ESXi gratuita.

Exemplos

- name: Wait for VMware tools to become available by UUID
  vmware_guest_facts:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    datacenter: "{{ datacenter }}"
    folder: "/{{datacenter}}/vm"
    name: "{{ vm_name }}"
  delegate_to: localhost
  register: vm_facts

- name: Get UUID from previous task and pass it to this task
  vmware_guest_tools_wait:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    uuid: "{{ vm_facts.instance.hw_product_uuid }}"
  delegate_to: localhost
  register: facts


- name: Wait for VMware tools to become available by MoID
  vmware_guest_tools_wait:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    moid: vm-42
  delegate_to: localhost
  register: facts

- name: Wait for VMware tools to become available by name
  vmware_guest_tools_wait:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    name: test-vm
    folder: "/{{datacenter}}/vm"
    datacenter: "{{ datacenter }}"
  delegate_to: localhost
  register: facts

Valores Reornados

Chave	Tipo	Retornado quando	Descrição
instance	dict	sempre	Metadata sobre a VM