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 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 .
Configurar atualização durante reparo
Para configurar a atualização no reparo, use o Trusted Cloud console, a CLI gcloud ou o REST.
Console
No console Trusted 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.s3nsapis.fr/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.s3nsapis.fr/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 Trusted Cloud , a CLI gcloud ou REST para ver a configuração de atualização durante reparo.
Console
No console Trusted 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.s3nsapis.fr/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 Trusted Cloud console, a CLI gcloud ou o REST para desativar a atualização no reparo.
Console
No console Trusted 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.s3nsapis.fr/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.
[[["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."],[[["This document explains how to configure and manage \"update on repair\" for Managed Instance Groups (MIGs), which allows applying the latest instance template and per-instance configurations when a VM is recreated during repair operations."],["By default, MIGs use the original instance configuration during VM repair, but \"update on repair\" allows you to apply available updates to the instance template or per-instance configurations."],["You can enable or disable \"update on repair\" for a MIG using the Google Cloud console, gcloud CLI, or REST API, with gcloud commands and REST calls provided for both new and existing MIGs."],["The document provides detailed instructions on how to check whether \"update on repair\" is enabled, using the console, gcloud CLI (with the `describe` command), and REST API, with examples of the expected output."],["If \"update on repair\" is enabled and the MIG update policy is `PROACTIVE`, then the `maxUnavailable` setting will be disregarded during update on repair."]]],[]] -