VMware Host Auto Start

6 min

Resumo

Neste módulo, é possível configurar a inicialização e desligamento automático de máquinas virtuais de acordo com a inicialização ou desligamento do host.

Parâmetros

Parâmetro	Tipo	Escolhas \| Valor Padrão	Comentários
esxi_hostname - required	string		Nome do host ESXi onde existe a VM para definir a ativação ou desativação automática.
moid	string		ID do objeto gerenciado da instância a ser gerenciada, se conhecido, este é um identificador exclusivo apenas em uma única instância do vCenter. Isso será necessário se nome ou uuid não for fornecido.
name	string		Nome da VM para definir a ativação ou desativação automática. Isso não é necessário se alterar apenas as configurações padrão da VM do sistema para a configuração de inicialização automática.
power_info	dictionary	Default: {"start_action": "none", "start_delay": -1, "start_order": -1, "stop_action": "systemDefault", "stop_delay": -1, "wait_for_heartbeat": "systemDefault"}	Configurações de inicialização ou desligamento da máquina virtual. Essa configuração substituirá os padrões do sistema.
system_defaults	dictionary		Padrões do sistema para configuração de inicialização automática ou parada automática para máquina virtual.
use_instance_uuid	boolean	Escolhas: - true - false (default)	Se deve ser usado o UUID da instância VMware em vez do UUID do BIOS.
uuid	string		VM uuid para ativar ou desativar a ativação automática, este é o identificador exclusivo do VMware. Isso é necessário se nome não for fornecido. Isso não é necessário se alterar apenas as configurações de VM padrão do sistema para configuração de início automático.

Subcampos da opção power_info

Parâmetro	Tipo	Escolhas \| Valor Padrão	Comentários
start_action	string	Escolhas: - 'none' (default) - 'powerOn'	Se deve iniciar a máquina virtual quando a inicialização do host.
start_delay	integer	-1 (default)	Atraso de início automático em segundos da máquina virtual.
start_order	integer	-1 (default)	A prioridade de inicialização automática da máquina virtual. As máquinas virtuais com um número mais baixo são ligadas primeiro. No desligamento do host, as máquinas virtuais são desligadas na ordem inversa, o que significa que aquelas com um número mais alto são desligadas primeiro.
stop_action	string	Escolhas: - 'none' - 'systemDefault' (default) - 'powerOff' - 'suspend'	Ação de parada executada na máquina virtual quando o sistema para de máquina virtual.
stop_delay	integer	-1 (default)	Atraso de parada automática em segundos da máquina virtual.
wait_for_heartbeat	string	Escolhas: - 'no' - 'yes' - 'systemDefault' (default)	Continue a ligar o processamento quando o VMware Tools for iniciado.

Subcampos da opção system_defaults

Parâmetro	Tipo	Escolhas \| Valor Padrão	Comentários
enabled	boolean	Escolhas: - true - false (default)	Habilite o início ou a parada automática de máquinas virtuais.
start_delay	integer	120 (default)	Atraso de início automático padrão em segundos.
stop_action	string	Escolhas: - 'none' - 'guestShutdown' - 'powerOff' - 'suspend'	Ação de parada padrão executada na máquina virtual quando o sistema para.
stop_delay	integer	120 (default)	Atraso de parada automática padrão em segundos.
wait_for_heartbeat	boolean	Escolhas: - true - false (default)	Continue a ligar o processamento quando o VMware Tools for iniciado. Se este parâmetro estiver ativado para ligar a próxima máquina virtual sem esperar que o atraso passe. No entanto, a máquina virtual deve ter o VMware Tools instalado.

Exemplos

# Exemplo: Atualização para configuração de padrões do sistema.
- vmware_host_auto_start:
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    esxi_hostname: "{{ esxi_hostname }}"
    system_defaults:
      enabled: true
      start_delay: 100
      stop_action: guestShutdown
      stop_delay: 120
      wait_for_heartbeat: false

# Exemplo: Atualização para configuração powerInfo da máquina virtual.
- vmware_host_auto_start:
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    esxi_hostname: "{{ esxi_hostname }}"
    name: "{{ vm_name }}"
    power_info:
      start_action: powerOn
      start_delay: 10
      start_order: 1
      stop_action: powerOff
      wait_for_heartbeat: true

Valores retornados

Chave	Tipo	Retornado quando	Descrição
power_info_config	dictionary	Modificado	Retorno de parâmetro quando a configuração de informações de energia da máquina virtual é alterada.
system_defaults_config	dictionary	Modificado	Retorno do parâmetro quando a configuração padrão do sistema é alterada.