Desativar reparos em um MIG

Neste documento, descrevemos como desativar os reparos de VMs com falha e não íntegras em um grupo gerenciado de instâncias (MIG) e, se já estiver desativado, como configurar o MIG para reparar VMs.

Por padrão, um MIG repara automaticamente uma VM com falha no grupo recriando essa VM. Se você configurou uma verificação de integridade baseada em aplicativo, o MIG também reparará as VMs não íntegras em que o aplicativo falhou na verificação de integridade. O reparo de uma VM com base em uma verificação de integridade do aplicativo também é chamado de recuperação automática.

Se você não quiser que um MIG repare uma VM com falha ou não íntegra, desative os reparos no MIG. Desativar os reparos é útil em cenários em que você quer solucionar problemas de uma VM com falha, implementar sua própria lógica de reparo ou monitorar a integridade do aplicativo sem reparar VMs não íntegras.

Para verificar se os reparos já estão desativados em um MIG, consulte Verificar a configuração de reparo em um MIG.

Para mais informações sobre reparos em um MIG, consulte Como reparar VMs para alta disponibilidade.

Antes de começar

  • Configure a autenticação, caso ainda não tenha feito isso. Com isso, você confirma sua identidade para acesso a Google Cloud serviços e APIs do. Para executar código ou exemplos de um ambiente de desenvolvimento local, faça a autenticação no Compute Engine com uma destas opções:

    Selecione a guia para como planeja usar as amostras nesta página:

    Console

    Quando você usa o Google Cloud console para acessar Google Cloud serviços e APIs, não é necessário configurar a autenticação.

    gcloud

    1. Instale a Google Cloud CLI. Após a instalação, inicialize a Google Cloud CLI executando o seguinte comando: 

      gcloud init

      Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

  • Defina uma região e uma zona padrão.

    • REST

    Para usar as amostras da API REST desta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para a CLI gcloud.

      Instale a Google Cloud CLI.

      Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

    Saiba mais em Autenticar para usar REST na documentação de autenticação do Google Cloud .

Desativar reparos em um MIG

Quando você desativa os reparos em um MIG, por padrão, os reparos de VMs com falha e a recuperação automática são desativados. Se você quiser desativar apenas a recuperação automática, consulte Desativar a recuperação automática.

Console

  1. No console, do Google Cloud , acesse a página Grupos de instâncias.

    Acesse grupo de instâncias

  2. Clique no nome do MIG em que você quer desativar o reparo.

  3. Clique em Editar.

  4. Clique em Ciclo de vida da instância e recuperação automática para abrir a seção.

    1. Na seção Ação em caso de falha, defina o campo Ação padrão em caso de falha como Nenhuma ação.
    2. Se você configurou a recuperação automática e não quer que o MIG a desative, na seção Recuperação automática, defina o campo Na verificação de integridade com falha como Reparar instância.

  5. Clique em Salvar.

gcloud

Para desativar os reparos em um MIG, use o update comando da seguinte maneira. Isso desativa a recuperação automática por padrão.

gcloud compute instance-groups managed update MIG_NAME \
    --default-action-on-vm-failure=do-nothing \
    --zone=ZONE

Se a recuperação automática estiver configurada no MIG e você não quiser desativar a recuperação automática por padrão, use o update comando para definir a flag --action-on-vm-failed-health-check como repair. Isso garante que a recuperação automática de VMs não íntegras continue funcionando mesmo que o reparo de VMs com falha esteja desativado.

gcloud compute instance-groups managed update MIG_NAME \
    --default-action-on-vm-failure=do-nothing \
    --action-on-vm-failed-health-check=repair \
    --zone=ZONE

Substitua:

  • MIG_NAME: o nome do grupo de instâncias.
  • ZONE: a zona em que o MIG está localizado; Para um MIG regional, use a sinalização --region=REGION.

REST

Para desativar os reparos em um MIG, use os métodos de API da seguinte maneira. Isso desativa a recuperação automática por padrão.

Por exemplo, faça a seguinte chamada em um MIG zonal. Isso desativa a recuperação automática por padrão.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME

{
  "instanceLifecyclePolicy":
    {
      "defaultActionOnFailure": "DO_NOTHING"
    }
  }

Se a recuperação automática estiver configurada no MIG e você não quiser desativá-la por padrão, use os métodos de API da seguinte maneira para definir a flag onFailedHealthCheck como REPAIR. Isso garante que a recuperação automática de VMs não íntegras continue funcionando mesmo que o reparo de VMs com falha esteja desativado.

Por exemplo, faça a seguinte chamada em um MIG zonal:

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME

{
  "instanceLifecyclePolicy":
    {
      "defaultActionOnFailure": "DO_NOTHING",
      "onFailedHealthCheck": "REPAIR"
    }
  }

Substitua:

  • PROJECT_ID: o ID do projeto.
  • MIG_NAME: o nome do MIG;
  • ZONE: a zona em que o MIG está localizado. Para um MIG regional, use regions/REGION no URL.

Limitações

Se um MIG tiver qualquer um dos seguintes, não será possível desativar os reparos no MIG definindo o campo defaultActionOnFailure como DO_NOTHING:

Desativar a recuperação automática

Quando você configura uma verificação de integridade do aplicativo em um MIG, se não quiser que o MIG repare VMs não íntegras, desative a recuperação automática separadamente. Isso não desativa os reparos de VMs com falha.

Console

  1. No console, do Google Cloud , acesse a página Grupos de instâncias.

    Acesse grupo de instâncias

  2. Clique no nome do MIG em que você quer desativar a recuperação automática.

  3. Clique em Editar.

  4. Clique em Ciclo de vida da instância e recuperação automática para abrir a seção.

  5. Na seção Recuperação automática, defina o campo Na verificação de integridade com falha como Nenhuma ação.

  6. Clique em Salvar.

gcloud

Para desativar a recuperação automática em um MIG, use o update comando e defina a --action-on-vm-failed-health-check flag como do-nothing.

Por exemplo, use o comando a seguir para um MIG zonal:

gcloud compute instance-groups managed update MIG_NAME \
    --action-on-vm-failed-health-check=do-nothing \
    --zone=ZONE

Substitua:

  • MIG_NAME: o nome do MIG;
  • ZONE: a zona em que o MIG está localizado. Para um MIG regional, use a sinalização --region=REGION.

REST

Para desativar a recuperação automática em um MIG, use os métodos de API da seguinte maneira e defina a flag --action-on-vm-failed-health-check como do-nothing.

Por exemplo, faça a seguinte solicitação para desativar a recuperação automática em um MIG zonal:

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME

{
  "instanceLifecyclePolicy":
   {
     "onFailedHealthCheck": "DO_NOTHING"
   }
}

Substitua:

  • PROJECT_ID: o ID do projeto.
  • ZONE: a zona em que o MIG está localizado. Para um MIG regional, use regions/REGION no URL.
  • MIG_NAME: o nome do grupo de instâncias.

Ativar reparos ou recuperação automática

Por padrão, um MIG repara VMs com falha e, se a recuperação automática estiver configurada, o MIG também reparará VMs não íntegras. Se você desativou os reparos ou a recuperação automática ou ambos, poderá ativá-los novamente.

Console

  1. No console, do Google Cloud , acesse a página Grupos de instâncias.

    Acesse grupo de instâncias

  2. Clique no nome do MIG em que você quer ativar o reparo.

  3. Clique em Editar.

  4. Clique em Ciclo de vida da instância e recuperação automática para abrir a seção.

    • Para reparar VMs com falha, na seção Ação em caso de falha, defina o campo Ação padrão em caso de falha como Reparar instância.
    • Para reparar VMs não íntegras, na seção Recuperação automática, defina o campo Na verificação de integridade com falha como Reparar instância. Se você definir esse valor como Ação padrão, a recuperação automática usará a mesma configuração definida para o campo Ação padrão em caso de falha.

  5. Quando terminar, clique em Salvar para aplicar as mudanças.

gcloud

Para ativar os reparos em um MIG, use o update comando. Isso também ativa a recuperação automática, se o valor da flag --action-on-vm-failed-health-check for default-action.

gcloud compute instance-groups managed update MIG_NAME \
    --default-action-on-vm-failure=repair

Se você desativou a recuperação automática separadamente e quer ativá-la novamente, use o update comando:

gcloud compute instance-groups managed update MIG_NAME \
    --action-on-vm-failed-health-check=default-action OR repair

Substitua:

  • MIG_NAME pelo nome de um MIG.
  • default-action OR repair: se você quiser que a recuperação automática use a mesma configuração definida para reparos de VMs com falha, defina o valor como default-action. Por exemplo, quando você desativa o reparo de VMs com falha, o MIG também desativa a recuperação automática. Se você quiser controlar os reparos de VMs não íntegras separadamente, defina o valor como repair.

REST

Para ativar os reparos em um MIG, use o método de API da seguinte maneira. Isso também ativa a recuperação automática, se o valor do campo onFailedHealthCheck for DEFAULT_ACTION.

Por exemplo, faça a seguinte solicitação em um MIG zonal:

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME
    {
      "instanceLifecyclePolicy": {
        "defaultActionOnFailure": "REPAIR"
      }
    }

Se você desativou a recuperação automática separadamente e quer ativá-la novamente, use o método de API da seguinte maneira:

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME
  {
    "instanceLifecyclePolicy": {
      "onFailedHealthCheck": "DEFAULT_ACTION OR REPAIR"
    }
  }

Substitua:

  • PROJECT_ID: o ID do projeto.
  • ZONE: a zona em que o MIG está localizado; Para um MIG regional, use regions/REGION no URL.
  • MIG_NAME: o nome do MIG;
  • DEFAULT_ACTION OR REPAIR: se você quiser que a recuperação automática use a mesma configuração que para reparos de VMs com falha, defina o valor como DEFAULT_ACTION. Por exemplo, quando você desativa o reparo de VMs com falha, o MIG também desativa a recuperação automática. Se você quiser configurar a recuperação automática separadamente, defina o valor como REPAIR.

A seguir