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 Trusted Cloud 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:

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

    Console

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

    gcloud

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

      gcloud init
    2. Set a default region and zone.

    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.

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

      gcloud init

    Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Trusted 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 Trusted 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 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 Trusted 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 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, o MIG também vai reparar 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 Trusted 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 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