Desativar reparos em um MIG

Neste documento, descrevemos 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 corrige as VMs não íntegras em que o aplicativo falha 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 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 a CLI gcloud.

          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 .

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 a desative, defina o campo Na falha da verificação de integridade como Reparar instância.

  6. Clique em Salvar.

gcloud

Para desativar os reparos em um MIG, use o comando update 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 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 não íntegras 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 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 da 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 algum dos seguintes itens, não será possível desativar os reparos nele 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, é possível desativar a recuperação automática separadamente se não quiser que o MIG repare VMs não íntegras. 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 caso de falha na verificação de integridade 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, ele também repara VMs não íntegras. Se você desativou os reparos ou a recuperação automática 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 Na verificação de integridade com falha como Reparar instância. Se você definir esse valor como Ação padrão, o autohealing 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 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 de novo, use o comando beta update:

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

Substitua:

  • MIG_NAME com o 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 de novo, 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ê quiser que a recuperação automática use a mesma configuração das correções 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