Adicione e remova VMs de um MIG

Depois de criar um grupo de instâncias geridas (GIG), pode querer adicionar ou remover VMs desse grupo para satisfazer as necessidades da sua carga de trabalho. Se atingiu o limite predefinido para o número máximo de VMs que pode adicionar a um MIG e precisar de mais VMs, pode aumentar o limite de tamanho do MIG.

Para adicionar ou remover VMs num MIG, pode fazer o seguinte:

• Adicione ou remova automaticamente VMs definindo o tamanho de destino do GIG:
  • Use o dimensionamento automático para aplicações sem estado
  • Crie um pedido de redimensionamento na MIG
  • Defina manualmente o tamanho do MIG
• Adicione, remova ou abandone manualmente instâncias específicas:
  • Crie instâncias com nomes específicos
  • Elimine instâncias específicas
  • Abandone instâncias específicas

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 Trusted Cloud by S3NS 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 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 Google Cloud e, em seguida, inicie sessão na CLI gcloud com a sua identidade federada. Depois de iniciar sessão, inicialize a CLI gcloud executando o seguinte comando:

     gcloud init

  2. Set a default region and zone.

  Terraform

  Para usar os exemplos do Terraform nesta página num ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e, em seguida, configure as credenciais predefinidas da aplicação com as suas credenciais de utilizador.

  Instale a CLI Google Cloud e, em seguida, inicie sessão na CLI gcloud com a sua identidade federada.

  Create local authentication credentials for your user account:

  gcloud auth application-default login

  If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

  Para mais informações, consulte Set up authentication for a local development environment.

  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 e, em seguida, inicie sessão na CLI gcloud com a sua identidade federada.

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

Defina o tamanho alvo do grupo

Pode definir o tamanho-alvo de um MIG automaticamente através de um escalador automático ou definir o tamanho manualmente.

Adicionar e remover automaticamente VMs num MIG

Pode configurar grupos de instâncias geridas para adicionar ou remover automaticamente VMs com base nas respetivas cargas de trabalho. As suas aplicações podem processar facilmente os aumentos no tráfego, e pode reduzir os custos quando a necessidade de recursos de computação é inferior. Para começar a dimensionar os seus grupos de instâncias geridas, consulte o artigo Crie um MIG com o dimensionamento automático.

Para mais informações, consulte o artigo Grupos de escalamento automático de instâncias.

Crie um pedido de redimensionamento

Pode usar pedidos de redimensionamento para adicionar VMs de GPU a um MIG de uma só vez. Esta funcionalidade ajuda a evitar custos por capacidade parcial enquanto o Compute Engine aprovisiona todos os recursos. Os pedidos de redimensionamento do MIG usam os modelos de aprovisionamento flex-start ou associados a reservas. Estes modelos permitem-lhe obter vCPUs e GPUs a um preço com desconto.

Para mais informações, consulte o artigo Acerca dos pedidos de redimensionamento num MIG.

Definir manualmente o tamanho de um MIG

Se um grupo de instâncias gerido ainda não estiver definido para dimensionamento automático, pode redimensionar o grupo manualmente para alterar o número de instâncias. Se aumentar o tamanho, o grupo de instâncias gerido usa o modelo de instância atual para adicionar novas instâncias. Se diminuir o tamanho, o grupo de instâncias gerido elimina as VMs do grupo. O grupo elimina instâncias com um currentAction de DELETING, CREATING e RECREATING antes de eliminar instâncias que estão a ser executadas sem ações agendadas.

Se o grupo fizer parte de um serviço de back-end que tenha ativado a drenagem de ligações, pode demorar até mais 60 segundos após o fim da duração da drenagem de ligações antes de a instância de VM ser removida ou eliminada.

gcloud compute instance-groups managed resize INSTANCE_GROUP_NAME \
    --size NEW_SIZE \
    --zone ZONE

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resize?size=NEW_SIZE

Depois de fazer um pedido para redimensionar um grupo de instâncias gerido, as VMs são iniciadas ou paradas assim que o sistema as puder aprovisionar ou eliminar. Este processo pode demorar um período significativo, consoante o número de instâncias no grupo. Valide o estado das instâncias no seu grupo de instâncias gerido.

Desativar o modo de novas tentativas de criação durante o redimensionamento

Por predefinição, se a criação inicial de uma instância de VM falhar, o grupo de instâncias gerido tenta continuamente criar a VM, até que a VM seja criada com êxito. No entanto, se não quiser novas tentativas de criação automáticas, pode desativar o modo de novas tentativas de criação quando redimensionar o grupo de instâncias. Neste modo, o grupo de instâncias geridas tenta criar todas as instâncias apenas uma vez. Se ocorrer um erro durante a criação da instância, o grupo de instâncias geridas desiste desta instância, remove-a da lista de instâncias geridas do grupo e diminui o tamanho de destino do grupo de instâncias geridas.

Este modo aplica-se apenas durante a primeira tentativa de criação de uma VM. Se uma VM for criada com êxito enquanto este modo estiver ativado, a VM comporta-se da mesma forma que todas as outras VMs criadas com um pedido de redimensionamento normal. Em particular, se uma VM em execução falhar inesperadamente mais tarde e precisar de ser recriada, este modo não afeta o comportamento de recriação nesse cenário.

Desativar o modo de novas tentativas de criação é especialmente útil em cenários em que tem sistemas a criar automaticamente grupos de VMs em que não é necessário um número exato de VMs. Pode preferir estabilizar rapidamente o tamanho do grupo de instâncias gerido e ser flexível no número de VMs no grupo, em vez de esperar indefinidamente até que todas as instâncias pedidas sejam criadas, o que pode ser atrasado temporária ou permanentemente devido a erros de quota ou outros problemas não relacionados.

Limitações

• Não pode desativar as novas tentativas de criação para um GIG regional com um formato de distribuição de destino EVEN.
• Para MIGs regionais com um formato de distribuição de destino BALANCED ou ANY_SINGLE_ZONE, tem de desativar a redistribuição proativa de instâncias antes de poder desativar o modo de novas tentativas de criação.
• Não pode desativar as novas tentativas de criação para MIGs com escalabilidade automática.

Para redimensionar um grupo de instâncias gerido quando o modo de novas tentativas de criação está desativado, use a Google Cloud CLI ou o REST.

gcloud beta compute instance-groups managed resize INSTANCE_GROUP_NAME \
    --size NEW_SIZE \
    --no-creation-retries \
    [--region REGION | --zone ZONE]

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeAdvanced

{
 "targetSize": NEW_SIZE,
 "noCreationRetries": true
}

Adicione, remova ou abandone instâncias específicas

As secções seguintes mostram como adicionar, remover ou abandonar instâncias específicas num MIG.

Criar instâncias com nomes específicos em MIGs

Se a sua carga de trabalho ou sistema de orquestração exigir nomes de instâncias específicos, pode adicionar essas instâncias a um MIG existente. Esta secção mostra como adicionar instâncias com base na disponibilidade. Se os recursos estiverem indisponíveis, o MIG adiciona uma parte das instâncias e cria as restantes quando os recursos ficarem disponíveis. Para adicionar instâncias de GPU com nomes específicos de uma só vez a um MIG, consulte Criar um pedido de redimensionamento neste documento.

Os nomes que atribui a estas instâncias persistem se o MIG as recriar. Para mais informações sobre como preservar o estado das instâncias de MIG, consulte os MIGs com estado.

Limitações

Se criar instâncias com nomes específicos:

• Tem de desativar o ajuste de escala automático durante o processo de criação da instância.
• Tem de definir a política de atualização do MIG como oportunista.
• Se estiver a atualizar um MIG regional:
  • Tem de desativar a redistribuição proativa de instâncias.
  • Não pode selecionar a zona na qual criar a VM.
• Não pode usar nomes de instâncias de VM duplicados num projeto.

Pode usar a CLI gcloud ou a REST para adicionar VMs com nomes específicos a um MIG existente.

gcloud compute instance-groups managed create-instance INSTANCE_GROUP_NAME \
    --instance INSTANCE_NAME \
    [--region REGION | --zone ZONE]

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/createInstances
{
  "instances": [
    {
      "name": "INSTANCE_NAME_1"
    },
    {
      "name": "INSTANCE_NAME_2"
    }
  ]
}

Eliminar instâncias específicas de um grupo

Pode eliminar instâncias de VMs individuais num grupo de instâncias geridas. A eliminação de instâncias reduz o número especificado de instâncias do grupo de instâncias e remove as VMs de todos os conjuntos de destino dos quais são membros.targetSize

A eliminação de instâncias específicas de um grupo de instâncias gerido não altera nenhuma das definições do escalador automático especificadas. Se eliminar instâncias de um grupo de instâncias gerido, o escalador automático pode detetar um aumento na carga de trabalho nas outras instâncias do grupo e aumentar o tamanho do grupo novamente para o nível anterior. Para evitar esta situação, pare o escalador automático antes de tentar eliminar as instâncias.

Se o grupo fizer parte de um serviço de back-end que tenha ativado a drenagem de ligações, pode demorar até mais 60 segundos após o fim da duração da drenagem de ligações antes de a instância de VM ser removida ou eliminada.

gcloud compute instance-groups managed delete-instances INSTANCE_GROUP_NAME \
    --instances INSTANCE_NAME_1,INSTANCE_NAME_2 \ 
    [--region REGION | --zone ZONE]

gcloud compute instance-groups managed delete-instances example-mig \
    --instances=example-instance-1,example-instance-2,example-instance-3,example-instance-4 \
    --region=us-central1 \
    --skip-instances-on-validation-error

Updated [https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/instanceGroupManagers/example-mig].
PROJECT          ZONE           INSTANCE               STATUS   VALIDATION_ERROR
example-project  us-central1-a  example-instance-1     SKIPPED  Cannot delete instance https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-instance-1 that was already deleted.
example-project  us-central1-a  example-instance-2     SKIPPED  Cannot delete instance https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-instance-2 that was already abandoned.
example-project  us-central1-a  example-instance-3     SUCCESS
example-project  us-central1-a  example-instance-4     SKIPPED  Cannot find instance https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-instance-4.

gcloud compute instance-groups managed delete-instances example-mig \
    --instances=example-instance-1,example-instance-2,example-instance-3,example-instance-4 \
    --region=us-central1

Updated [https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/instanceGroupManagers/example-mig].
PROJECT          ZONE             INSTANCE              STATUS
example-project  us-central1-a    example-instance-1    FAIL
example-project  us-central1-a    example-instance-2    FAIL
example-project  us-central1-a    example-instance-3    FAIL
example-project  us-central1-a    example-instance-4    FAIL

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

{
  "instances": [
    "zones/ZONE/instances/INSTANCE_NAME_1",
    "zones/ZONE/instances/INSTANCE_NAME_2"
   ]
}

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

{
 "instances": [
  "zones/ZONE/instances/INSTANCE_NAME_1",
  "zones/ZONE/instances/INSTANCE_NAME_2"
 ],
 "skipInstancesOnValidationError": true
}

Depois de fazer um pedido para eliminar instâncias num grupo de instâncias gerido, as instâncias param assim que o sistema as consegue eliminar. Este processo pode demorar um período significativo, consoante o número de instâncias que eliminar do grupo. Verifique o estado do grupo ou verifique o estado das instâncias geridas.

Abandonar instâncias de um MIG

Pode separar uma instância de VM de um grupo de instâncias geridas para resolver problemas com instâncias individuais sem afetar o grupo como um todo. Abandonar uma instância de um grupo também remove a instância dos equilibradores de carga que foram atribuídos ao grupo de instâncias gerido. Os grupos de destino que foram atribuídos manualmente a instâncias individuais específicas não são removidos.

Não pode adicionar novamente uma instância de VM abandonada ao grupo. O abandono de instâncias reduz o targetSize especificado do grupo de instâncias, mas não altera as definições do escalador automático especificadas. Os grupos de instâncias geridos com um escalador automático continuam a adicionar ou remover instâncias automaticamente conforme necessário. Para um GIG regional com a escala automática definida para o modo ONLY_SCALE_OUT, se abandonar uma instância de VM para reduzir o tamanho alvo do GIG para o tamanho recomendado do escalador automático, o escalador automático pode criar uma nova instância de VM na mesma zona da VM abandonada. Nestes casos, para evitar a criação de uma nova instância de VM, experimente abandonar a instância de VM a partir de uma zona diferente.

Se o grupo fizer parte de um serviço de back-end que tenha ativado a drenagem de ligações, pode demorar até mais 60 segundos após o fim da duração da drenagem de ligações antes de a instância de VM ser removida ou eliminada.

gcloud compute instance-groups managed abandon-instances INSTANCE_GROUP_NAME \
    --instances INSTANCE_NAME_1,INSTANCE_NAME_2 \
    [--region REGION | --zone ZONE]

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

{
 "instances": [
  "zones/ZONE/instances/INSTANCE_NAME_1",
  "zones/ZONE/instances/INSTANCE_NAME_2"
 ]
}

Depois de fazer um pedido para abandonar instâncias de um grupo de instâncias gerido, o grupo remove as instâncias assim que possível. Verifique o estado do grupo ou verifique o estado das instâncias geridas.

Aumente o limite de tamanho do grupo

Por predefinição, o limite de tamanho para um GIG zonal é de 1000 VMs e o limite de tamanho para um GIG regional é de 2000 VMs. Pode aumentar ainda mais estes limites para 2000 VMs para um GIG zonal e 4000 VMs para um GIG regional.

Para aumentar os limites, defina o campo listManagedInstancesResults do grupo como PAGINATED. Se ainda precisar de mais VMs no grupo, crie vários MIGs ou contacte o apoio técnico.

gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
    --list-managed-instances-results=PAGINATED

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --template INSTANCE_TEMPLATE \
    --size SIZE \
    --list-managed-instances-results=PAGINATED

resource "google_compute_instance_group_manager" "default" {
  name                           = "my-igm"
  base_instance_name             = "test"
  target_size                    = 7
  zone                           = "us-central1-f"
  list_managed_instances_results = "PAGINATED"
  version {
    instance_template = google_compute_instance_template.default.id
    name              = "primary"
  }
}

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

{
  "listManagedInstancesResults": "PAGINATED",
}

Se quiser voltar aos resultados da lista sem paginação, também tem de reverter para o limite de tamanho predefinido do grupo. Para voltar a usar o grupo original, primeiro, certifique-se de que o grupo não excede o limite de tamanho predefinido e, em seguida, defina o campo listManagedInstancesResults como PAGELESS.

O que se segue?

• Saiba como trabalhar com instâncias geridas, por exemplo, para eliminar, abandonar e recriar instâncias geridas.
• Veja informações sobre grupos de instâncias geridas e instâncias geridas.
• Resolva problemas de grupos de instâncias geridas.