Neste documento, descrevemos como configurar o MIG para aplicar o modelo de instância mais recente e configurações por instância ao recriar uma VM durante operações de repair. A aplicação da configuração mais recente disponível durante uma operação de reparo também é conhecida como atualização durante reparo. Neste documento, também descrevemos como verificar se a atualização durante o reparo está ativada no MIG e, se ativada, como desativar a atualização durante o reparo.
Por padrão, durante um reparo, um MIG recria uma VM com a mesma configuração de instância usada originalmente para criar a VM. Se as atualizações para o modelo de instância do grupo ou configurações por instância estiverem disponíveis, há a opção de aplicar essas alterações a uma VM que esteja sendo corrigida.
Se você quiser aplicar automaticamente atualizações de configuração a todas as VMs ou a um conjunto delas
(PROACTIVE
) ou atualizar instâncias específicas (OPPORTUNISTIC
), consulte
Como aplicar novas configurações a VMs de um MIG.
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
-
Instale a CLI do Google Cloud. Após a instalação, inicialize a CLI do Google Cloud executando o seguinte comando:
gcloud init
Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.
- 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. Após a instalação, inicialize a CLI do Google Cloud executando o seguinte comando:
gcloud init
Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.
Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud .
Configurar atualização durante reparo
Para configurar a atualização no reparo, use o Google Cloud console, a CLI gcloud ou o REST.
Console
No console Google Cloud , acesse a página Grupos de instâncias.
Clique no nome do MIG em que você quer configurar a atualização durante o reparo.
Clique em Editar para modificar o MIG.
Clique em Ciclo de vida da instância e recuperação automática para abrir a seção.
Na seção Atualizações durante o reparo da instância de VM, selecione Atualizar a configuração da instância.
Clique em Salvar.
gcloud
Para um MIG atual, use o comando
update
Beta:gcloud compute instance-groups managed update MIG_NAME \ --force-update-on-repair
Para um novo MIG, use o comando
create
:gcloud compute instance-groups managed create MIG_NAME \ --template INSTANCE_TEMPLATE_URL_ \ --size SIZE \ --force-update-on-repair
Substitua:
MIG_NAME
: o nome do grupo de instâncias.INSTANCE_TEMPLATE_URL
: o URL do modelo de instância que você quer usar para criar VMs no MIG. O URL pode conter o ID ou o nome do modelo de instância. Especifique um dos seguintes valores:- Para um modelo de instância regional:
projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
- Para um modelo de instância global:
INSTANCE_TEMPLATE_ID
- Para um modelo de instância regional:
SIZE
: o tamanho de destino do grupo de instâncias.
REST
Para um MIG zonal, use o método
instanceGroupManagers.patch
ou, para um MIG regional, use o métodoregionInstanceGroupManagers.patch
.Faça a seguinte chamada para configurar a atualização durante reparo em um MIG zonal atual:
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME { "instanceLifecyclePolicy": { "forceUpdateOnRepair": YES } }
Para um MIG zonal novo, use o método
instanceGroupManagers.insert
ou, para um MIG regional novo, use o métodoregionInstanceGroupManagers.insert
.Faça a seguinte chamada para configurar a atualização durante reparo ao criar um MIG zonal:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers { "name": "MIG_NAME", "instanceTemplate": "INSTANCE_TEMPLATE_URL", "targetSize": SIZE, "instanceLifecyclePolicy": { "forceUpdateOnRepair": YES } }
Substitua:
PROJECT_ID
: o ID do projeto.ZONE
: a zona em que o MIG está localizado.MIG_NAME
: o nome do grupo de instâncias.INSTANCE_TEMPLATE_URL
: o URL do modelo de instância que você quer usar para criar VMs no MIG. O URL pode conter o ID ou o nome do modelo de instância. Especifique um dos seguintes valores:- Para um modelo de instância regional:
projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
- Para um modelo de instância global:
INSTANCE_TEMPLATE_ID
- Para um modelo de instância regional:
SIZE
: o tamanho de destino do grupo de instâncias.
Verificar se a atualização durante reparo está ativada
Por padrão, um MIG não atualiza uma VM durante um reparo. Para verificar se a atualização durante reparo está ativada para o MIG, use o console Google Cloud , a CLI gcloud ou REST para ver a configuração de atualização durante reparo.
Console
No console Google Cloud , acesse a página Grupos de instâncias.
Clique no nome do MIG do qual você quer verificar a configuração.
Clique na guia Detalhes.
Na seção Ciclo de vida da instância de VM, marque a opção selecionada para Atualizações durante reparo de instância de VM. Se o campo mostrar Atualizar a configuração da instância, a atualização durante reparo estará ativada.
gcloud
Use o comando
describe
da seguinte maneira.gcloud compute instance-groups managed describe MIG_NAME \ --format="(instanceLifecyclePolicy)"
No corpo da resposta, verifique o campo
forceUpdateOnRepair
, que tem um dos seguintes valores:NO
: Padrão. O MIG não atualiza as VMs quando elas são corrigidas.YES
: o MIG atualiza as VMs durante o reparo.
Veja um exemplo de saída:
instanceLifecyclePolicy: forceUpdateOnRepair: YES
REST
Para um MIG zonal, use o método
instanceGroupManagers.get
ou, para um MIG regional, use o métodoregionInstanceGroupManagers.get
.Por exemplo, em um MIG zonal, use o seguinte comando:
GET https://compute.googleapis.com/compute/v1/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME
No corpo da resposta, verifique o campo
instanceLifecyclePolicy.forceUpdateOnRepair
, que tem um dos seguintes valores:NO
: Padrão. O MIG não atualiza as VMs quando elas são corrigidas.YES
: o MIG atualiza as VMs durante o reparo.
Veja a seguir um exemplo de resposta:
{ ... "name": "example-mig", "targetSize": 12, ... "instanceLifecyclePolicy": { "forceUpdateOnRepair": "YES" }, ... }
Substitua:
PROJECT_ID
: o ID do projeto.ZONE
: a zona em que o MIG está localizado.MIG_NAME
: o nome do grupo de instâncias.
Desativar atualização durante reparo
Quando o MIG corrige uma VM, se você quiser que ele use o modelo de instância original ou as configurações por instância usadas para criar a VM, desative a atualização durante reparo. Por padrão, a atualização durante reparo fica desativada para um MIG.
Use o Google Cloud console, a CLI gcloud ou o REST para desativar a atualização no reparo.
Console
No console Google Cloud , acesse a página Grupos de instâncias.
Clique no nome do MIG no qual você quer desativar a atualização durante reparo.
Clique em Editar para modificar o MIG.
Clique em Ciclo de vida da instância e recuperação automática para abrir a seção.
Na seção Atualizações durante o reparo da instância de VM, selecione Manter a mesma configuração da instância.
Clique em Salvar.
gcloud
Use o comando
update
para definir a flag--no-force-update-on-repair
da seguinte maneira:gcloud compute instance-groups managed update MIG_NAME \ --no-force-update-on-repair
REST
Para um MIG zonal, use o método
instanceGroupManagers.patch
ou, para um MIG regional, use o métodoregionInstanceGroupManagers.patch
.Por exemplo, para desativar a atualização durante reparo de um MIG zonal, use o seguinte comando:
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME { "instanceLifecyclePolicy": { "forceUpdateOnRepair": NO } }
Substitua:
PROJECT_ID
: o ID do projeto.ZONE
: a zona em que o MIG está localizado.MIG_NAME
: o nome do grupo de instâncias.
A seguir
- Configurar a verificação de integridade e recuperação automática de aplicativos
- Se você tiver configurado uma verificação de integridade baseada em aplicativo para o MIG, monitore as alterações do estado de integridade da 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.
-