Mudar ou remover a flexibilidade de instância

Neste documento, descrevemos como fazer mudanças ou remover a flexibilidade de instâncias em um grupo gerenciado de instâncias (MIG) editando a política de flexibilidade de instâncias.

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

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

É possível fazer as seguintes alterações editando a configuração de flexibilidade de instância em um MIG:

  • Adicionar um tipo de máquina a uma seleção de instância
  • Remover um tipo de máquina de uma seleção de instâncias
  • Mudar as classificações das seleções de instâncias
  • Adicionar uma seleção de instância

O MIG aplica as mudanças com base nos nomes de seleção de instâncias especificados. As seleções de instância que você não especificar vão permanecer inalteradas. Ao fazer mudanças em uma seleção de instâncias, é necessário especificar a configuração completa ao editar. Se você não especificar a configuração completa, o MIG vai substituir as partes não especificadas da seleção de instâncias. Por exemplo, se você quiser mudar apenas uma classificação, especifique a nova classificação com os tipos de máquina definidos nessa seleção. Para conferir a configuração atual, consulte Conferir a flexibilidade da instância.

Depois de fazer alterações na configuração de flexibilidade da instância, se você quiser que as VMs atuais usem as mudanças mais recentes, exclua essas VMs e redimensione o MIG para o número necessário de VMs. Caso contrário, as VMs atuais vão continuar usando os tipos de máquina atuais.

Para mudar a configuração de flexibilidade de instância em um MIG, selecione uma das seguintes opções:

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 mudar a flexibilidade da instância.

  3. Clique em Editar.

  4. Na seção Seleções de instância, clique em Editar seleções de instância.

  5. Na janela Seleções de instância, clique no ícone Alternar de uma seleção de instância para abrir a visualização Editar seleção de instância.

    Ao editar uma seleção de instâncias, é possível fazer as seguintes mudanças:

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

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

  7. Depois de fazer as mudanças na janela Seleções de instâncias, clique em Concluído.

  8. Clique em Salvar 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:

  • INSTANCE_GROUP_NAME: o nome do MIG em que você quer verificar a configuração de flexibilidade da instância.
  • REGION: a região em que o MIG está localizado.
  • INSTANCE_SELECTION: o nome da seleção de instância em que você quer fazer as mudanças. É necessário especificar MACHINE_TYPE e RANK. Se você não estiver mudando nenhum deles, forneça os valores atuais para mantê-los.

REST

Para editar uma configuração de flexibilidade de instância, faça uma solicitação PATCH para 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": {
          "machineTypes": [
            "MACHINE_TYPE_1",
            "MACHINE_TYPE_2"
          ],
          "rank": RANK
        }
      }
    }
  }

Substitua:

  • PROJECT_ID: o ID do projeto.
  • REGION: a região em que o MIG está localizado.
  • INSTANCE_GROUP_NAME: o nome do MIG em que você quer verificar a configuração de flexibilidade da instância.
  • INSTANCE_SELECTION: o nome da seleção de instância em que você quer fazer as mudanças. É necessário especificar MACHINE_TYPE e RANK. Se você não estiver mudando nenhum deles, forneça os valores atuais para mantê-los.

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

É possível remover todas ou apenas algumas seleções de instâncias em um MIG.

  • Para remover todas as seleções de instâncias em um MIG, consulte Remover todas as seleções de instâncias. Quando você remove todas as seleções de instâncias, o MIG 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 nome, consulte Remover seleções de instâncias específicas. Isso remove apenas seleções de instâncias específicas, e o MIG retém as outras.

Remover todas as seleções de instância

Depois de remover todas as seleções de instância, as VMs que estão usando os tipos de máquina das seleções de instância removidas continuam usando o mesmo tipo de máquina. Se você quiser que essas VMs usem o tipo de máquina especificado no modelo de instância, exclua essas VMs e redimensione o MIG para o número necessário de VMs.

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

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 mudar a flexibilidade da instância.

  3. Clique em Editar.

  4. Na seção Seleções de instância, clique em Editar seleções de instância.

  5. Na janela Seleções de instância, clique no ícone Excluir ao lado de cada seleção de instância.

  6. Clique em Concluído.

  7. Clique em Salvar.

gcloud

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

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

Substitua:

  • INSTANCE_GROUP_NAME: o nome do MIG de que você quer remover todas as seleções de instância.
  • REGION: a região em que o MIG está localizado.

REST

Para remover todas as seleções de instância em um MIG, faça uma solicitação PATCH para o método regionInstanceGroupManagers.patch.

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

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

Substitua:

  • PROJECT_ID: o ID do projeto.
  • REGION: a região em que o MIG está localizado.
  • INSTANCE_GROUP_NAME: o nome do MIG de que você quer remover uma seleção de instância.

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

Depois de remover uma seleção de instância específica, as VMs que estão usando os tipos de máquina da seleção de instância removida continuam usando o mesmo tipo de máquina. Se você quiser que essas VMs usem o tipo de máquina especificado nas seleções de instância disponíveis, exclua essas VMs e redimensione o MIG para o número necessário de VMs.

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

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 mudar a flexibilidade da instância.

  3. Clique em Editar.

  4. Na seção Seleções de instância, clique em Editar seleções de instância.

  5. Na janela Seleções de instâncias, clique no ícone Excluir ao lado da seleção de instância que você quer remover.

  6. Clique em Concluído.

  7. Clique em Salvar.

gcloud

Para remover seleções de instâncias específicas em um 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:

  • INSTANCE_GROUP_NAME: o nome do MIG de que você quer remover uma seleção de instância.
  • REGION: a região em que o MIG está localizado.
  • INSTANCE_SELECTION: o nome da seleção de instância que você quer remover. Se houver várias seleções de instância, forneça uma lista de nomes separados por vírgulas.

REST

Para remover seleções de instâncias específicas em um 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:

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

A seguir