Desativar reparos em um MIG

Este documento descreve como desativar os reparos de VMs com falhas 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 repara 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 baseada em 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 se os reparos estão desativados 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. A autenticação é o processo de verificação da sua identidade para acesso a serviços e APIs do Google Cloud . Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no Compute Engine selecionando uma das seguintes opções:

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. After installing the Google Cloud CLI, initialize it by running the following command: 

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    2. Set a default region and zone.

      3. REST

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

        After installing the Google Cloud CLI, initialize it by running the following command: 

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

      Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.

Limitações

Não será possível desativar os reparos em um MIG se o grupo tiver:

Desativar reparos em um MIG

Quando você desativa os reparos em um MIG, por padrão, os reparos de VM 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 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. Na seção Ciclo de vida da instância de VM, defina o campo Ação padrão em caso de falha como Nenhuma ação.

  5. Se você configurou a recuperação automática e não quer que o MIG desative essa opção, defina o campo On failed health check como Repair instance.

  6. Clique em Salvar.

gcloud

Para desativar os reparos em um MIG, use o comando update da seguinte maneira. Isso desativa a correçã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 desativá-la por padrão, use o comando Beta update para definir a flag --action-on-vm-failed-health-check como repair. Isso garante que a recuperação automática de VMs com problemas continue funcionando, mesmo que o reparo de VMs com falha esteja desativado.

gcloud beta 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 correção automática por padrão.

Por exemplo, faça a seguinte chamada em um MIG zonal. Isso desativa a autocorreção 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 da API da seguinte maneira para definir a flag onFailedHealthCheck como REPAIR. Isso garante que a recuperação automática de VMs com problemas continue funcionando mesmo que o reparo de VMs com falhas seja 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.

Desativar a recuperação automática

Depois de configurar uma verificação de integridade do aplicativo em um MIG, se você 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 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. Na seção Ciclo de vida da instância de VM, defina o campo Em verificação de integridade com falha como Nenhuma ação.

  5. Clique em Salvar.

gcloud

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

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

gcloud beta 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:

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers

{
  "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 consertos 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 repara VMs não íntegras. Se você desativou os reparos ou a autocorreção ou ambos, é possível reativá-los.

Console

  1. No console 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. Na seção Ciclo de vida da instância de VM, faça o seguinte:

    • Para reparar VMs com falha, defina o campo Ação padrão em caso de falha como Reparar instância.
    • Para reparar VMs não íntegras, defina o campo On failed health check como Repair instance. Se você definir esse valor como Ação padrão, o reparo automático vai 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 comando update. Isso também ativa a autocorreção, 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 autocorreção separadamente e quer reativá-la, use o comando update Beta:

gcloud beta 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ê quer que a autocorreção use a mesma configuração que você configurou 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 autocorreção, 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 autocorreção separadamente e quer reativá-la, use o método da API Beta da seguinte maneira:

  PATCH https://compute.googleapis.com/compute/beta/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ê quer que a autocorreção use a mesma configuração 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