--- title: VMware Cluster slug: homologacao-atmosphere/vmware-cluster description: Learn how to add or remove VMware vSphere clusters with this comprehensive document. Discover new modules for managing DRS, HA, and VSAN configurations. Understand the importance of case sensitivity for VMware values and object names. Tested on ESXi 7.0.2 docTags: createdAt: 2022-01-19T12:54:39.000Z --- ## Resumo - Adiciona ou remove clusters VMware vSphere. - Para gerenciar configurações relacionadas a DRS, HA e VSAN, use os novos módulos vmware\_cluster\_drs, vmware\_cluster\_ha e vmware\_cluster\_vsan. - Todos os valores e nomes de objetos VMware diferenciam maiúsculas de minúsculas. ## Requisitos - Testado no ESXi 7.0.2 ## Parâmetros | **Parâmetro** | **Tipo** | **Escolhas \| Valor Padrão** | **Comentários** | | ------------------------------------ | -------- | ---------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | cluster\_name - required | string | | O nome do cluster a ser gerenciado. | | datacenter - required | string | | O nome do datacenter. | | drs\_default\_vm\_behavior | string | Escolhas:
- fullyAutomated ←
- manual
- partiallyAutomated | Especifica o comportamento DRS padrão em todo o cluster para máquinas virtuais.

Se definido como partiallyAutomated, o vCenter gerará recomendações para migração de máquina virtual e para o posicionamento com um host. O vCenter implementa automaticamente o posicionamento ao ligar.

Se definido como manual, o vCenter gerará recomendações para migração de máquina virtual e para o posicionamento com um host. O vCenter não deve implementar as recomendações automaticamente. | | drs\_enable\_vm\_behavior\_overrides | boolean | Escolhas:
- false
- true ← | Determina se as substituições de comportamento DRS para máquinas virtuais individuais estão habilitadas. | | drs\_vmotion\_rate | integer | Escolhas:
- 1
- 2
- 3 ←
- 4
- 5 | Limite para ClusterRecommendations gerado. | | enable\_drs | boolean | Escolhas:
- false ←
- true | Se definido como True, habilitará o DRS quando o cluster for criado. | | enable\_ha | boolean | Escolhas:
- false ←
- true | Se definido como `True` habilitará o HA quando o cluster for criado. | | enable\_vsan | boolean | Escolhas:
- false ←
- true | Se definido como `True` habilitará o vSAN quando o cluster for criado. | | ha\_admission\_control\_enabled | boolean | Escolhas:
- false
- true ← | Determina se o controle de admissão estrito está ativado.

Recomenda-se definir este parâmetro como True, consulte a documentação para obter mais detalhes. | | ha\_failover\_level | integer | Default:
- 2 | Número de falhas de host que devem ser toleradas, ainda garantindo recursos suficientes para reiniciar as máquinas virtuais nos hosts disponíveis.

Aceita apenas valores inteiros. | | ha\_host\_monitoring | string | Escolhas:
- enabled ←
- disabled | Indica se o HA reinicia as máquinas virtuais após a falha de um host.

Se definido como enabled, o HA reinicia as máquinas virtuais após a falha de um host.

Se definido como disabled, o HA não reinicia as máquinas virtuais após a falha de um host.

Se `enable_ha` estiver definido como False, esse valor será ignorado. | | ha\_restart\_priority | string | Escolhas:
- disabled
- high
- low
- medium ← | Determina a preferência que o HA dá a uma máquina virtual se não houver capacidade suficiente disponível para ligar todas as máquinas virtuais com falha.

Essa configuração só é válida se `ha_vm_monitoring` estiver definida como `vmAndAppMonitoring` ou `vmMonitoringOnly`.Se definido como `disabled`, o HA será desabilitado para esta máquina virtual.

Se definido como `high`, a máquina virtual com essa prioridade terá uma chance maior de ligar após uma falha, quando houver capacidade insuficiente nos hosts para atender a todas as necessidades da máquina virtual.

Se definido como medium, a máquina virtual com essa prioridade terá uma chance intermediária de ligar após uma falha, quando houver capacidade insuficiente nos hosts para atender a todas as necessidades da máquina virtual.

Se definido como low, a máquina virtual com essa prioridade terá uma chance menor de ligar após uma falha, quando houver capacidade insuficiente nos hosts para atender a todas as necessidades da máquina virtual. | | ha\_vm\_failure\_interval | integer | Default:
- 30 | O número de segundos após o qual a máquina virtual é declarada como com falha se nenhuma pulsação tiver sido recebida.

Essa configuração só é válida se `ha_vm_monitoring` estiver definida como `vmAndAppMonitoring` ou `vmMonitoringOnly`. | | ha\_vm\_max\_failure\_window | integer | Default:
- '-1' | O número de segundos para a janela durante a qual até `ha_vm_max_failures` redefinições podem ocorrer antes que as respostas automáticas parem.

Essa configuração só é válida se `ha_vm_monitoring` estiver definida como `vmAndAppMonitoring` ou `vmMonitoringOnly`.

A unidade é segundos. | | ha\_vm\_max\_failures | integer | Default:
- 3 | Número máximo de falhas e reinicializações automáticas permitidas durante o tempo `ha_vm_max_failure_window` especificado.

Essa configuração só é válida se `ha_vm_monitoring` estiver definida como `vmAndAppMonitoring` ou `vmMonitoringOnly`. | | ha\_vm\_min\_up\_time | integer | Default:
- 120 | O número de segundos para que as pulsações da máquina virtual se estabilizem após a máquina virtual ser ligada.

Essa configuração só é válida se `ha_vm_monitoring` estiver definida como `vmAndAppMonitoring` ou `vmMonitoringOnly`. | | ha\_vm\_monitoring | string | Choices:
- vmAndAppMonitoring
- vmMonitoringOnly
- vmMonitoringDisabled ← | Indica o estado do serviço de monitoramento de integridade da máquina virtual.

Se definido como `vmAndAppMonitoring`, resposta de alta disponibilidade à falha de pulsação da máquina virtual e do aplicativo.

Se definido como `vmMonitoringDisabled`, o monitoramento de integridade da máquina virtual é desabilitado.

Se definido como `vmMonitoringOnly`, resposta de alta disponibilidade à falha de pulsação da máquina virtual.

Se `enable_ha` estiver definido como `False`, esse valor será ignorado. | | hostname | string | | O nome do host ou endereço IP do servidor vSphere vCenter ou ESXi.

Se o valor não for especificado na tarefa, o valor da variável de ambiente VMWARE\_HOST será usado. | | ignore\_drs | boolean | Escolhas:
- false ←
- true | Se definido como `True`, o DRS não será configurado; todas as configurações explícitas e padrão relacionadas ao DRS serão ignoradas. | | ignore\_ha | boolean | Escolhas:
- false ←
- true | Se definido como `True`, o HA não será configurado; todas as configurações explícitas e padrão relacionadas a HA serão ignoradas. | | ignore\_vsan | boolean | Escolhas:
- false ←
- true | Se definido como `True`, o Virtual SAN não será configurado; todas as configurações explícitas e padrão relacionadas ao Virtual SAN serão ignoradas. | | password | string | | A senha do servidor vSphere vCenter ou ESXi.

Se o valor não for especificado na tarefa, o valor da variável de ambiente `VMWARE_PASSWORD` será usado. | | port | integer | Default:
443 | O número da porta do servidor vSphere vCenter ou ESXi.

Se o valor não for especificado na tarefa, o valor da variável de ambiente `VMWARE_PORT` será usado. | | proxy\_host | string | | Endereço de um proxy que receberá todas as solicitações HTTPS e as retransmitirá.

O formato é um nome de host ou um IP.

Se o valor não for especificado na tarefa, o valor da variável de ambiente `VMWARE_PROXY_HOST` será usado. | | proxy\_port | integer | | Porta do proxy HTTP que receberá todas as solicitações HTTPS e as retransmitirá.

Se o valor não for especificado na tarefa, o valor da variável de ambiente `VMWARE_PROXY_PORT` será usado. | | state | string | Escolhas:
- absent
- present ← | Crie presentou remova absentum cluster VMware vSphere. | | username | string | | O nome de usuário do servidor vSphere vCenter ou ESXi.

Se o valor não for especificado na tarefa, o valor da variável de ambiente `VMWARE_USER` será usado. | | validate\_certs | boolean | Escolhas:
- 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. | | vsan\_auto\_claim\_storage | boolean | Escolhas:
- false ←
- true | Determina se o serviço Virtual SAN está configurado para reivindicar automaticamente o armazenamento local em hosts habilitados para Virtual SAN no cluster. | ## Notas - Todos os módulos requerem acesso de gravação à API e, portanto, não são compatíveis com uma licença ESXi gratuita. ## Exemplos ```yaml - name: Criar cluster vmware_cluster: hostname: '{{ vcenter_hostname }}' username: '{{ vcenter_username }}' password: '{{ vcenter_password }}' datacenter_name: datacenter cluster_name: cluster enable_ha: true enable_drs: true enable_vsan: true delegate_to: localhost - name: Criar cluster com alterações adicionais vmware_cluster: hostname: "{{ vcenter_hostname }}" username: "{{ vcenter_username }}" password: "{{ vcenter_password }}" datacenter_name: DC0 cluster_name: "{{ cluster_name }}" enable_ha: True ha_vm_monitoring: vmMonitoringOnly enable_drs: True drs_default_vm_behavior: partiallyAutomated enable_vsan: True register: cl_result delegate_to: localhost - name: Excluir cluster vmware_cluster: hostname: "{{ vcenter_hostname }}" username: "{{ vcenter_username }}" password: "{{ vcenter_password }}" datacenter_name: datacenter cluster_name: cluster enable_ha: true enable_drs: true enable_vsan: true state: absent delegate_to: localhost ```