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.

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

    1. 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
    2. 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

  1. No console Trusted 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 o 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 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
  • 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.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étodo regionInstanceGroupManagers.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
  • 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

  1. No console Trusted 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.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

  1. No console Trusted 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 o 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.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