Altere ou remova a flexibilidade da instância

Este documento descreve como fazer alterações ou remover a flexibilidade das instâncias num grupo de instâncias gerido (MIG) editando a política de flexibilidade das instâncias. Também descreve como atualizar o tipo de máquina de uma VM quando o tipo de máquina é removido da configuração de flexibilidade da instância.

Antes de começar

  • Se ainda não o tiver feito, configure a autenticação. A autenticação valida a sua identidade para aceder a Google Cloud serviços e APIs. Para executar código ou exemplos a partir de um ambiente de desenvolvimento local, pode autenticar-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 Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

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

      gcloud init

      Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

    2. Set a default region and zone.

    REST

    Para usar os exemplos da API REST nesta página num ambiente de desenvolvimento local, usa as credenciais que fornece à CLI gcloud.

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

      gcloud init

      Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

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

Altere a configuração da flexibilidade da instância

Pode fazer as seguintes alterações editando a configuração de flexibilidade das instâncias num MIG:

  • Adicione um tipo de máquina a uma seleção de instâncias
  • Remova um tipo de máquina de uma seleção de instâncias
  • Alterar as classificações das seleções de instâncias
  • Adicione uma seleção de instância

O MIG aplica as alterações com base nos nomes de seleção de instâncias que especificar. As seleções de instâncias que não especificar permanecem inalteradas. Quando faz alterações a uma seleção de instâncias, tem de especificar a respetiva configuração completa quando a edita. Se não especificar a configuração completa, o MIG substitui as partes não especificadas da seleção de instâncias. Por exemplo, se quiser alterar apenas uma classificação, especifique a nova classificação juntamente com os tipos de máquinas definidos nessa seleção. Para ver a configuração existente, consulte o artigo Veja a flexibilidade da instância.

Depois de remover um tipo de máquina da configuração, as VMs existentes com os tipos de máquinas removidos continuam a usá-los. Se quiser alterar os tipos de máquinas dessas VMs, tem de atualizar ou recriar as VMs específicas. Para mais informações, consulte Atualize o tipo de máquina de uma VM para usar a configuração mais recente.

Para alterar a configuração da flexibilidade das instâncias num MIG, selecione uma das seguintes opções:

Consola

  1. Na Google Cloud consola, aceda à página Grupos de instâncias.

    Aceda a Grupos de instâncias

  2. Clique no nome do MIG no qual quer alterar a flexibilidade da instância.

  3. Clique em Edit.

  4. Clique em Flexibilidade da instância para expandir a secção.

  5. Na secção Seleções de instâncias, clique em Editar seleções.

  6. Na janela Seleções de instâncias, clique no ícone Ativar/desativar de uma seleção de instâncias para abrir a vista Editar seleção de instâncias.

    Quando edita uma seleção de instâncias, pode fazer as seguintes alterações:

    • Altere o nome e a classificação da seleção de instâncias. Para tal, edite os valores nos campos Nome e Classificação.
    • Adicione um novo tipo de máquina à seleção. Para tal, clique em Adicionar tipo de máquina.
    • Remova tipos de máquinas. Para o fazer, selecione os tipos de máquinas e, de seguida, clique em Remover.

  7. Modifique a seleção conforme necessário e clique em Concluído.

  8. Depois de concluir as alterações na janela Seleções de instâncias, clique em Concluído.

  9. Clique em Guardar para aplicar as alterações.

gcloud

Para editar uma configuração de flexibilidade de instância, use o comando instance-groups managed update.

  gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
      --region REGION \
      --instance-selection "name=INSTANCE_SELECTION_1,machine-type=MACHINE_TYPE_1,machine-type=MACHINE_TYPE_2,rank=RANK_1" \
      --instance-selection "name=INSTANCE_SELECTION_2,machine-type=MACHINE_TYPE_3,machine-type=MACHINE_TYPE_4,rank=RANK_2"

Substitua o seguinte:

  • INSTANCE_GROUP_NAME: o nome do MIG no qual quer verificar a configuração de flexibilidade da instância.
  • REGION: a região onde o MIG está localizado.
  • INSTANCE_SELECTION: o nome da seleção de instâncias na qual quer fazer as alterações. Tem de especificar MACHINE_TYPE e RANK. Se não alterar nenhuma destas opções, tem de fornecer os valores existentes para os manter.

REST

Para editar uma configuração de flexibilidade da instância, faça um pedido PATCH ao método regionInstanceGroupManagers.patch.

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME

  {
    "instanceFlexibilityPolicy": {
      "instanceSelections": {
        "INSTANCE_SELECTION": {
          "machineTypes": [
            "MACHINE_TYPE_1",
            "MACHINE_TYPE_2"
          ],
          "rank": RANK
        }
      }
    }
  }

Substitua o seguinte:

  • PROJECT_ID: o seu ID do projeto.
  • REGION: a região onde o MIG está localizado.
  • INSTANCE_GROUP_NAME: o nome do MIG no qual quer verificar a configuração de flexibilidade da instância.
  • INSTANCE_SELECTION: o nome da seleção de instâncias na qual quer fazer as alterações. Tem de especificar MACHINE_TYPE e RANK. Se não alterar nenhuma destas opções, tem de fornecer os valores existentes para os manter.

Remova a configuração de flexibilidade da instância

Pode remover todas ou seleções de instâncias específicas num MIG.

  • Para remover todas as seleções de instâncias num MIG, consulte o artigo Remova todas as seleções de instâncias. Quando remove todas as seleções de instâncias, o GIG usa o tipo de máquina especificado no modelo de instância para criar novas VMs no grupo.

  • Para remover seleções de instâncias individuais por nomes, consulte o artigo Remova seleções de instâncias específicas. Isto remove apenas seleções de instâncias específicas e o MIG retém as outras.

Depois de remover as seleções de instâncias, as VMs existentes que usam os tipos de máquinas das seleções de instâncias removidas continuam a usar o mesmo tipo de máquina. Para que as alterações entrem em vigor, tem de atualizar ou recriar essas VMs. Para mais informações, consulte o artigo Atualize o tipo de máquina de uma VM para usar a configuração mais recente.

Remova todas as seleções de instâncias

Para remover todas as seleções de instâncias, selecione uma das seguintes opções:

Consola

  1. Na Google Cloud consola, aceda à página Grupos de instâncias.

    Aceda a Grupos de instâncias

  2. Clique no nome do MIG no qual quer remover todas as seleções de instâncias.

  3. Clique em Edit.

  4. Clique em Flexibilidade da instância para expandir a secção.

  5. Na secção Seleções de instâncias, clique em Editar seleções.

  6. Na janela Seleções de instâncias, clique no ícone Eliminar junto a cada seleção de instância.

  7. Clique em Concluído.

  8. Clique em Guardar.

gcloud

Para remover todas as seleções de instâncias num MIG, use o comando instance-groups managed update:

  gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
      --region REGION \
      --remove-instance-selections-all

Substitua o seguinte:

  • INSTANCE_GROUP_NAME: o nome do MIG do qual quer remover todas as seleções de instâncias.
  • REGION: a região onde o MIG está localizado.

REST

Para remover todas as seleções de instâncias num MIG, faça um pedido PATCH ao método regionInstanceGroupManagers.patch.

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME

  {
    "instanceFlexibilityPolicy": {
      "instanceSelections": null
    }
  }

Substitua o seguinte:

  • PROJECT_ID: o seu ID do projeto.
  • REGION: a região onde o MIG está localizado.
  • INSTANCE_GROUP_NAME: o nome do MIG do qual quer remover uma seleção de instâncias.

Remova seleções de instâncias específicas

Para remover seleções de instâncias específicas, selecione uma das seguintes opções:

Consola

  1. Na Google Cloud consola, aceda à página Grupos de instâncias.

    Aceda a Grupos de instâncias

  2. Clique no nome do MIG no qual quer remover seleções de instâncias específicas.

  3. Clique em Edit.

  4. Clique em Flexibilidade da instância para expandir a secção.

  5. Na secção Seleções de instâncias, clique em Editar seleções.

  6. Na janela Seleções de instâncias, clique no ícone Eliminar junto à seleção de instâncias que quer remover.

  7. Clique em Concluído.

  8. Clique em Guardar.

gcloud

Para remover seleções de instâncias específicas num MIG, use o comando instance-groups managed update:

  gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
      --region REGION \
      --remove-instance-selections INSTANCE_SELECTION

Substitua o seguinte:

  • INSTANCE_GROUP_NAME: o nome do MIG do qual quer remover uma seleção de instâncias.
  • REGION: a região onde o MIG está localizado.
  • INSTANCE_SELECTION: o nome da seleção da instância que quer remover. Se existirem várias seleções de instâncias, indique uma lista de nomes separados por vírgulas.

REST

Para remover seleções de instâncias específicas num MIG, use o método regionInstanceGroupManagers.patch.

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME

  {
    "instanceFlexibilityPolicy": {
      "instanceSelections": {
        "INSTANCE_SELECTION": null
      }
    }
  }

Substitua o seguinte:

  • PROJECT_ID: o seu ID do projeto.
  • REGION: a região onde o MIG está localizado.
  • INSTANCE_GROUP_NAME: o nome do MIG do qual quer remover uma seleção de instâncias.
  • INSTANCE_SELECTION: o nome da seleção da instância que quer remover. Se existirem várias seleções de instâncias, especifique todas. Por exemplo, "selection-1": null,"selection-2": null.

Atualize o tipo de máquina de uma VM para usar a configuração mais recente

Se alguma VM num MIG usar um tipo de máquina que foi removido da configuração de flexibilidade da instância, tem de atualizar ou recriar a VM para atualizar o respetivo tipo de máquina.

Para atualizar ou recriar uma VM, use uma das seguintes opções:

  • Atualize as VMs através do método regionInstanceGroupManagers.applyUpdatesToInstances. Quando usar o método applyUpdatesToInstances, o campo mostDisruptiveAllowedAction tem de ser RESTART OU REPLACE.

  • Recrie as VMs com o método regionInstanceGroupManagers.recreateInstances.

  • Recrie as VMs eliminando-as primeiro e, em seguida, redimensionando o MIG para o número necessário de VMs.

O que se segue?