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
-
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
- 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
No console Trusted Cloud , acesse a página Grupos de instâncias.
Clique no nome do MIG em que você quer desativar o reparo.
Clique em Editar.
Clique em Ciclo de vida da instância e recuperação automática para abrir a seção.
- Na seção Ação em caso de falha, defina o campo Ação padrão em caso de falha como Nenhuma ação.
- 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.
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
comorepair
. 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.
- Para um MIG zonal, use o método
instanceGroupManagers.patch
. - Para um MIG regional, use o método
regionInstanceGroupManagers.patch
.
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
comoREPAIR
. 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.- Para um MIG zonal, use o método
beta.instanceGroupManagers.patch
. - Para um MIG regional, use o método
beta.regionInstanceGroupManagers.patch
.
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, useregions/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
comoDO_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
No console Trusted Cloud , acesse a página Grupos de instâncias.
Clique no nome do MIG em que você quer desativar a recuperação automática.
Clique em Editar.
Clique em Ciclo de vida da instância e recuperação automática para abrir a seção.
Na seção Recuperação automática, defina o campo Em caso de falha na verificação de integridade como Nenhuma ação.
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
comodo-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
comodo-nothing
.- Para um MIG zonal, use o método
beta.instanceGroupManagers.patch
. - Para um MIG regional, use o método
beta.regionInstanceGroupManagers.patch
.
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, useregions/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
No console Trusted Cloud , acesse a página Grupos de instâncias.
Clique no nome do MIG em que você quer ativar o reparo.
Clique em Editar.
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.
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
fordefault-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
ORrepair
Substitua:
MIG_NAME
com o nome de um MIG.default-action
ORrepair
: se você quiser que a recuperação automática use a mesma configuração definida para reparos de VMs com falha, defina o valor comodefault-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 comorepair
.
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
forDEFAULT_ACTION
.- Para um MIG zonal, use o método
instanceGroupManagers.patch
. - Para um MIG regional, use o método
regionInstanceGroupManagers.patch
.
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:
- Para um MIG zonal, use o método
beta.instanceGroupManagers.patch
. - Para um MIG regional, use o método
beta.regionInstanceGroupManagers.patch
.
PATCH https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME { "instanceLifecyclePolicy": { "onFailedHealthCheck": "
DEFAULT_ACTION
ORREPAIR
" } }Substitua:
PROJECT_ID
: o ID do projeto.ZONE
: a zona em que o MIG está localizado; Para um MIG regional, useregions/REGION
no URL.MIG_NAME
: o nome do MIG;DEFAULT_ACTION
ORREPAIR
: se você quiser que a recuperação automática use a mesma configuração das correções de VMs com falha, defina o valor comoDEFAULT_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 comoREPAIR
.
A seguir
- Conferir se os reparos estão desativados em um MIG.
- Investigue os erros em uma VM com falha listando erros de instância.
- Inspecione o estado de integridade de uma VM.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-19 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-19 UTC."],[[["\u003cp\u003eThis document provides instructions on how to disable automatic VM repairs in a Managed Instance Group (MIG), which can be useful for troubleshooting, custom repair logic, or application health monitoring.\u003c/p\u003e\n"],["\u003cp\u003eBy default, MIGs automatically repair failed or unhealthy VMs, but this feature can be turned off through the Google Cloud console, gcloud CLI, or REST API, by setting the "Default action on failure" to "No action".\u003c/p\u003e\n"],["\u003cp\u003eDisabling repairs will halt both automatic and application-based health check repairs, and it cannot be done on MIGs that have autoscaling configurations or suspended/stopped VMs.\u003c/p\u003e\n"],["\u003cp\u003eIf repairs are turned off, you can re-enable the automatic repair of failed or unhealthy VMs by using the console, gcloud CLI, or REST API, by setting the "Default action on failure" to "Repair instances".\u003c/p\u003e\n"],["\u003cp\u003eThe document offers guidance on authenticating to Google Cloud services and lists required permissions to complete these tasks.\u003c/p\u003e\n"]]],[],null,[]] -