Alterar ou remover flexibilidade de instância


Este documento descreve como fazer alterações ou remover a flexibilidade de instância em um grupo gerenciado de instâncias (MIG) editando a política de flexibilidade de instância. 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 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.

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

Você pode fazer as seguintes alterações editando a configuração de flexibilidade da 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ância
  • Alterar as classificações das seleções de instância
  • Adicionar uma seleção de instância

O MIG aplica as alterações com base nos nomes de seleção de instância que você especifica. Quaisquer seleções de instância que você não especificar permanecerão inalteradas. Ao fazer alterações em uma seleção de instância, você deve especificar sua configuração completa durante a edição. Se você não especificar a configuração completa, o MIG substituirá as partes não especificadas da seleção da instância. Por exemplo, se desejar alterar apenas uma classificação, especifique a nova classificação juntamente com os tipos de máquinas definidos nessa seleção. Para visualizar a configuração existente, consulte Visualizar flexibilidade da instância .

Depois de remover um tipo de máquina da configuração, as VMs existentes com os tipos de máquina removidos continuarão a usá-lo. Se quiser alterar os tipos de máquina dessas VMs, você deverá atualizar ou recriar as VMs específicas. Para obter mais informações, consulte Atualizar o tipo de máquina de uma VM para usar a configuração mais recente .

Para alterar a configuração de flexibilidade da 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 .

    Vá para grupos de instâncias

  2. Clique no nome do MIG no qual deseja alterar 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ância, você pode fazer as seguintes alterações:

    • Altere o nome e a classificação da seleção de instância. 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 .
    • Remova os tipos de máquinas. 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 concluir as alterações na janela de seleções de instância , 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 o seguinte:

  • INSTANCE_GROUP_NAME : o nome do MIG no qual deseja verificar a configuração de flexibilidade da instância.
  • REGION : região onde o MIG está localizado.
  • INSTANCE_SELECTION : o nome da seleção da instância na qual você deseja fazer as alterações. Você deve especificar MACHINE_TYPE e RANK . Se você não estiver alterando nada disso, deverá fornecer os valores existentes para mantê-los.

DESCANSAR

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

  • PROJECT_ID : seu ID do projeto .
  • REGION : região onde o MIG está localizado.
  • INSTANCE_GROUP_NAME : o nome do MIG no qual deseja verificar a configuração de flexibilidade da instância.
  • INSTANCE_SELECTION : o nome da seleção da instância na qual você deseja fazer as alterações. Você deve especificar MACHINE_TYPE e RANK . Se você não estiver alterando nada disso, deverá fornecer os valores existentes para mantê-los.

Remover configuração de flexibilidade de instância

Você pode remover todas as seleções de instâncias ou específicas em um MIG.

  • Para remover todas as seleções de instância em um MIG, consulte Remover todas as seleções de instância . Ao remover todas as seleções de instância, 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 nomes, 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.

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

Remover todas as seleções de instância

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 .

    Vá para grupos de instâncias

  2. Clique no nome do MIG no qual deseja alterar 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 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ância 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 o seguinte:

  • INSTANCE_GROUP_NAME : o nome do MIG do qual você deseja remover todas as seleções de instância.
  • REGION : região onde o MIG está localizado.

DESCANSAR

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

  • PROJECT_ID : seu ID do projeto .
  • REGION : região onde o MIG está localizado.
  • INSTANCE_GROUP_NAME : o nome do MIG do qual você deseja remover uma seleção de instância.

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

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 .

    Vá para grupos de instâncias

  2. Clique no nome do MIG no qual deseja alterar 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 lado da seleção de instância que você deseja 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 o seguinte:

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

DESCANSAR

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

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

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

Se alguma VM em um MIG usar um tipo de máquina que foi removido da configuração de flexibilidade da instância, você deverá atualizar ou recriar a VM para atualizar seu tipo de máquina.

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

  • Atualize as VMs usando o método regionInstanceGroupManagers.applyUpdatesToInstances . Ao usar o método applyUpdatesToInstances , o campo mostDisruptiveAllowedAction deve ser RESTART OR REPLACE .

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

  • Recrie as VMs primeiro excluindo-as e depois redimensionando o MIG para o número necessário de VMs.

O que vem a seguir