Aplicar atualizações de configuração durante reparos

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

    1. Instale a Google Cloud CLI e inicialize-a executando o seguinte comando: 

      gcloud init
    2. 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

  1. No Console do Google Cloud, acesse a página Grupos de instâncias.

    Acesse grupo de instâncias

  2. Clique no nome do MIG em que você quer configurar a atualização durante reparo.

  3. Clique em Editar para modificar o MIG.

  4. 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.

  5. 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

  1. No Console do Google Cloud, acesse a página Grupos de instâncias.

    Acesse grupo de instâncias

  2. Clique no nome do MIG do qual você quer verificar a configuração.

  3. Clique na guia Detalhes.

  4. 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

  1. No Console do Google Cloud, acesse a página Grupos de instâncias.

    Acesse grupo de instâncias

  2. Clique no nome do MIG no qual você quer desativar a atualização durante reparo.

  3. Clique em Editar para modificar o MIG.

  4. 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.

  5. 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