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 reparo. 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 da seguinte maneira.
Selecione a guia para como planeja usar as amostras nesta página:
Console
Quando você usa o console do Google Cloud para acessar os serviços e as APIs do Google Cloud, não é necessário configurar a autenticação.
gcloud
-
Instale a Google Cloud CLI e inicialize-a 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 a CLI gcloud.
Instale a Google Cloud CLI e inicialize-a executando o seguinte comando:
gcloud init
-
Configurar atualização durante reparo
Para configurar a atualização no reparo, use o console do Google Cloud, a CLI gcloud ou a REST.
Console
No Console do Google Cloud, acesse a página Grupos de instâncias.
Clique no nome do MIG em que você quer configurar a atualização durante reparo.
Clique em Editar para modificar o MIG.
Na seção Ciclo de vida da instância de VM, para Atualizações durante o reparo da instância de VM, selecione Atualizar a configuração da instância.
Clique em Save.
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 \ --size SIZE \ --force-update-on-repair
Substitua:
MIG_NAME
: o nome do grupo de instâncias.INSTANCE_TEMPLATE
: o nome do modelo de instância que deve ser usado para o grupo.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étodo regionInstanceGroupManagers.patch
.
Faça a seguinte chamada para configurar a atualização durante reparo em um MIG zonal atual:
PATCH https://www.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étodo regionInstanceGroupManagers.insert
.
Faça a seguinte chamada para configurar a atualização durante reparo ao criar um MIG zonal:
POST https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers { "name": "MIG_NAME", "instanceTemplate": "INSTANCE_TEMPLATE", "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
: o nome do modelo de instância que deve ser usado para o grupo.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 no reparo está ativada para seu MIG, use o console do Google Cloud, a CLI gcloud ou REST para ver a atualização na configuração de reparo.
Console
No Console do 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 a opção Atualizar a configuração da instância estiver selecionada, a atualização durante reparo está 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étodo regionInstanceGroupManagers.get
.
Por exemplo, em um MIG zonal, use o seguinte comando:
GET https://compute.googleapis.com/compute/v1/projects/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 console do Google Cloud, a CLI gcloud ou o REST para desativar a atualização no reparo.
Console
No Console do 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.
Na seção Ciclo de vida da instância de VM, em Atualizações durante reparo da instância de VM, selecione Manter a mesma configuração da instância.
Clique em Save.
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étodo regionInstanceGroupManagers.patch
.
Por exemplo, para desativar a atualização durante reparo de um MIG zonal, use o seguinte comando:
PATCH https://www.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
- Configure a verificação de integridade e a 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.