Aplicar atualizações de configuração durante os 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 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.

Observação: se o tipo de atualização do MIG estiver definido como PROACTIVE e você configurar a atualização durante reparo, o MIG não considera o maxUnavailable durante a atualização durante reparo. Por exemplo, suponha que o maxUnavailable seja 5 e que o MIG já esteja no processo de atualizar cinco VMs com base na política de atualização. Entre as outras VMs do MIG, se três VMs falharem, o MIG atualizará todas as três durante o reparo, independentemente do maxUnavailable.

Antes de começar

• Configure a autenticação, caso ainda não tenha feito isso. Com isso, você confirma sua identidade para acesso a Google Cloud serviços e APIs do. Para executar código ou amostras de um ambiente de desenvolvimento local, faça a autenticação no Compute Engine selecionando uma das seguintes opções:

  Selecione a guia para como planeja usar as amostras nesta página:

  Console

  Quando você usa o Google Cloud console para acessar Google Cloud serviços e APIs, não é necessário configurar a autenticação.

  gcloud

  1. Instale a Google Cloud CLI. Após a instalação, inicialize a Google Cloud CLI executando o seguinte comando:

     gcloud init

     Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

     Observação: se você já tiver instalado a CLI gcloud, verifique se você tem a versão mais recente executando gcloud components update.
• Defina uma região e uma zona padrão.

REST

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

Instale a Google Cloud CLI.

Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

Saiba mais em Autenticar para usar REST na documentação de autenticação do Google Cloud .

Configurar atualização durante reparo

Para configurar a atualização durante reparo, use o Google Cloud console, 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. Clique em Ciclo de vida da instância e recuperação automática para abrir a seção.

5. Na seção Atualizações durante o reparo da instância de VM, selecione Atualizar a configuração da instância.

6. 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 instâncias 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
• 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://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étodo regionInstanceGroupManagers.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 instâncias 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
• 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 Google Cloud console, a CLI gcloud, ou a REST para visualizar a configuração de atualização durante 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 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étodo regionInstanceGroupManagers.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 a REST para desativar a atualização durante 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. Clique em Ciclo de vida da instância e recuperação automática para abrir a seção.

5. Na seção Atualizações durante reparo da instância de VM, selecione Manter a mesma configuração da instância.

6. 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étodo regionInstanceGroupManagers.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.