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.

    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

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

      Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

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