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

Este documento descreve como configurar seu MIG para aplicar o modelo de instância mais recente e as 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 no reparo . Este documento também descreve como verificar se a atualização no reparo está habilitada em seu MIG e, se habilitada, como desabilitar a atualização no reparo.

Por padrão, durante um reparo, um MIG recria uma VM usando a mesma configuração de instância usada originalmente para criar a VM. Se atualizações para o modelo de instância do grupo ou configurações por instância estiverem disponíveis, você terá a opção de aplicar essas alterações a uma VM que está sendo reparada.

Se você quiser aplicar automaticamente atualizações de configuração a todas ou a um conjunto de VMs ( PROACTIVE ) ou atualizar seletivamente instâncias específicas ( OPPORTUNISTIC ), consulte Aplicando novas configurações a VMs em um MIG .

Antes de começar

  • Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar 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 Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. After installing the Google Cloud CLI, initialize it by running the following command: 

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    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.

        After installing the Google Cloud CLI, initialize it by running the following command: 

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

      Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.

Configurar atualização no reparo

Para configurar a atualização no reparo, use o console do Google Cloud, a CLI gcloud ou REST.

Console

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

    Vá para grupos de instâncias

  2. Clique no nome do MIG onde deseja configurar a atualização no 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 o reparo da instância de VM , selecione Atualizar a configuração da instância .

  5. Clique em Salvar .

gcloud

Para um MIG existente, use o comando update :

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 o seguinte:

  • MIG_NAME : o nome do grupo de instâncias.
  • INSTANCE_TEMPLATE : o nome do modelo de instância a ser usado para o grupo.
  • SIZE : o tamanho alvo do grupo de instâncias.

DESCANSAR

Para um MIG zonal existente, use o método instanceGroupManagers.patch ou, para um MIG regional existente, use o método regionInstanceGroupManagers.patch .

Faça a seguinte chamada para configurar a atualização no reparo em um MIG zonal existente:

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME

{
"instanceLifecyclePolicy":
  { "forceUpdateOnRepair": YES
  }
}

Para um novo MIG zonal, use o método instanceGroupManagers.insert ou, para um novo MIG regional, use o método regionInstanceGroupManagers.insert .

Faça a seguinte chamada para configurar a atualização no 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",
"targetSize": SIZE,
"instanceLifecyclePolicy":
  { "forceUpdateOnRepair": YES
  }
}

Substitua o seguinte:

  • PROJECT_ID : o ID do seu projeto .
  • ZONE : A zona onde o MIG está localizado.
  • MIG_NAME : o nome do grupo de instâncias.
  • INSTANCE_TEMPLATE : o nome do modelo de instância a ser usado para o grupo.
  • SIZE : o tamanho alvo do grupo de instâncias.

Verifique se a atualização no reparo está habilitada

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 o REST para visualizar a configuração da atualização no reparo.

Console

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

    Vá para grupos de instâncias

  2. Clique no nome do MIG cuja configuração você deseja verificar.

  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 o reparo da instância de VM . Se Atualizar a configuração da instância estiver selecionado, a atualização no reparo será 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 possui um dos seguintes valores:

  • NO : Padrão. O MIG não atualiza VMs quando elas são reparadas.
  • YES : o MIG atualiza as VMs durante o reparo.

A seguir está um exemplo de saída:

instanceLifecyclePolicy:
 forceUpdateOnRepair: YES

DESCANSAR

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 possui um dos seguintes valores:

  • NO : Padrão. O MIG não atualiza VMs quando elas são reparadas.
  • YES : o MIG atualiza as VMs durante o reparo.

A seguir está um exemplo de resposta:

{
...
"name": "example-mig",
"targetSize": 12,
...
"instanceLifecyclePolicy": {
  "forceUpdateOnRepair": "YES"
  },
...
}

Substitua o seguinte:

  • PROJECT_ID : o ID do seu projeto .
  • ZONE : A zona onde o MIG está localizado.
  • MIG_NAME : o nome do grupo de instâncias.

Desativar atualização no reparo

Quando seu MIG repara uma VM, se você quiser que o MIG use o modelo de instância original ou as configurações por instância que foram usadas para criar a VM, você deverá desabilitar a atualização no reparo. Por padrão, a atualização no reparo está desabilitada para um MIG.

Use o console do Google Cloud, a CLI gcloud ou REST para desativar a atualização no reparo.

Console

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

    Vá para grupos de instâncias

  2. Clique no nome do MIG onde deseja desabilitar a atualização no 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 o reparo da instância de VM , selecione Manter a mesma configuração da instância .

  5. Clique em Salvar .

gcloud

Use o comando update para definir o sinalizador --no-force-update-on-repair da seguinte forma:

gcloud compute instance-groups managed update MIG_NAME \
    --no-force-update-on-repair

DESCANSAR

Para um MIG zonal, use o método instanceGroupManagers.patch ou, para um MIG regional, use o método regionInstanceGroupManagers.patch .

Por exemplo, para desabilitar a atualização no reparo para 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 o seguinte:

  • PROJECT_ID : o ID do seu projeto .
  • ZONE : A zona onde o MIG está localizado.
  • MIG_NAME : o nome do grupo de instâncias.

O que vem a seguir

,

Este documento descreve como configurar seu MIG para aplicar o modelo de instância mais recente e as 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 no reparo . Este documento também descreve como verificar se a atualização no reparo está habilitada em seu MIG e, se habilitada, como desabilitar a atualização no reparo.

Por padrão, durante um reparo, um MIG recria uma VM usando a mesma configuração de instância usada originalmente para criar a VM. Se atualizações para o modelo de instância do grupo ou configurações por instância estiverem disponíveis, você terá a opção de aplicar essas alterações a uma VM que está sendo reparada.

Se você quiser aplicar automaticamente atualizações de configuração a todas ou a um conjunto de VMs ( PROACTIVE ) ou atualizar seletivamente instâncias específicas ( OPPORTUNISTIC ), consulte Aplicando novas configurações a VMs em um MIG .

Antes de começar

  • Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar 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 Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. After installing the Google Cloud CLI, initialize it by running the following command: 

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    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.

        After installing the Google Cloud CLI, initialize it by running the following command: 

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

      Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.

Configurar atualização no reparo

Para configurar a atualização no reparo, use o console do Google Cloud, a CLI gcloud ou REST.

Console

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

    Vá para grupos de instâncias

  2. Clique no nome do MIG onde deseja configurar a atualização no 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 o reparo da instância de VM , selecione Atualizar a configuração da instância .

  5. Clique em Salvar .

gcloud

Para um MIG existente, use o comando update :

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 o seguinte:

  • MIG_NAME : o nome do grupo de instâncias.
  • INSTANCE_TEMPLATE : o nome do modelo de instância a ser usado para o grupo.
  • SIZE : o tamanho alvo do grupo de instâncias.

DESCANSAR

Para um MIG zonal existente, use o método instanceGroupManagers.patch ou, para um MIG regional existente, use o método regionInstanceGroupManagers.patch .

Faça a seguinte chamada para configurar a atualização no reparo em um MIG zonal existente:

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME

{
"instanceLifecyclePolicy":
  { "forceUpdateOnRepair": YES
  }
}

Para um novo MIG zonal, use o método instanceGroupManagers.insert ou, para um novo MIG regional, use o método regionInstanceGroupManagers.insert .

Faça a seguinte chamada para configurar a atualização no 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",
"targetSize": SIZE,
"instanceLifecyclePolicy":
  { "forceUpdateOnRepair": YES
  }
}

Substitua o seguinte:

  • PROJECT_ID : o ID do seu projeto .
  • ZONE : A zona onde o MIG está localizado.
  • MIG_NAME : o nome do grupo de instâncias.
  • INSTANCE_TEMPLATE : o nome do modelo de instância a ser usado para o grupo.
  • SIZE : o tamanho alvo do grupo de instâncias.

Verifique se a atualização no reparo está habilitada

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 o REST para visualizar a configuração da atualização no reparo.

Console

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

    Vá para grupos de instâncias

  2. Clique no nome do MIG cuja configuração você deseja verificar.

  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 o reparo da instância de VM . Se Atualizar a configuração da instância estiver selecionado, a atualização no reparo será 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 possui um dos seguintes valores:

  • NO : Padrão. O MIG não atualiza VMs quando elas são reparadas.
  • YES : o MIG atualiza as VMs durante o reparo.

A seguir está um exemplo de saída:

instanceLifecyclePolicy:
 forceUpdateOnRepair: YES

DESCANSAR

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 possui um dos seguintes valores:

  • NO : Padrão. O MIG não atualiza VMs quando elas são reparadas.
  • YES : o MIG atualiza as VMs durante o reparo.

A seguir está um exemplo de resposta:

{
...
"name": "example-mig",
"targetSize": 12,
...
"instanceLifecyclePolicy": {
  "forceUpdateOnRepair": "YES"
  },
...
}

Substitua o seguinte:

  • PROJECT_ID : o ID do seu projeto .
  • ZONE : A zona onde o MIG está localizado.
  • MIG_NAME : o nome do grupo de instâncias.

Desativar atualização no reparo

Quando seu MIG repara uma VM, se você quiser que o MIG use o modelo de instância original ou as configurações por instância que foram usadas para criar a VM, você deverá desabilitar a atualização no reparo. Por padrão, a atualização no reparo está desabilitada para um MIG.

Use o console do Google Cloud, a CLI gcloud ou REST para desativar a atualização no reparo.

Console

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

    Vá para grupos de instâncias

  2. Clique no nome do MIG onde deseja desabilitar a atualização no 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 o reparo da instância de VM , selecione Manter a mesma configuração da instância .

  5. Clique em Salvar .

gcloud

Use o comando update para definir o sinalizador --no-force-update-on-repair da seguinte maneira:

gcloud compute instance-groups managed update MIG_NAME \
    --no-force-update-on-repair

DESCANSAR

Para um MIG zonal, use o método instanceGroupManagers.patch ou, para um MIG regional, use o método regionInstanceGroupManagers.patch .

Por exemplo, para desabilitar a atualização no reparo para 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 o seguinte:

  • PROJECT_ID : o ID do seu projeto .
  • ZONE : A zona onde o MIG está localizado.
  • MIG_NAME : o nome do grupo de instâncias.

O que vem a seguir