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, confira 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 serviços e APIs do Cloud de Confiance by S3NS . Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no Compute Engine selecionando uma das seguintes opções:

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

    Console

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

    gcloud

    1. Instale a Google Cloud CLI e faça login na CLI gcloud com sua identidade federada. Depois de fazer login, inicialize a Google Cloud CLI executando o seguinte comando: 

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

    • REST

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

      Instale a Google Cloud CLI e faça login na CLI gcloud com sua identidade federada.

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

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, do Cloud de Confiance , 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 Em caso de falha na verificação de integridade como Reparar instância.

  5. 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.s3nsapis.fr/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.s3nsapis.fr/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, do Cloud de Confiance , 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 Em caso de falha na verificação de integridade como Nenhuma ação.

  6. 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.s3nsapis.fr/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 ativá-los novamente.

Console

  1. No console, do Cloud de Confiance , 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 Em caso de falha na verificação de integridade 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 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.s3nsapis.fr/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.s3nsapis.fr/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