Trabalhe com instâncias geridas

Um grupo de instâncias geridas (MIG) cria cada uma das respetivas instâncias geridas com base nos componentes de configuração que usa: modelo de instância, configuração opcional de todas as instâncias e configuração opcional com estado.

Cada instância gerida é uma entidade de dados que representa o estado pretendido para uma instância de máquina virtual (VM) real num GIG.

Leia este documento para saber como trabalhar de forma fiável com as instâncias geridas num MIG. Por exemplo, pode ter de adicionar, remover, atualizar ou ver informações acerca de uma instância específica.

Para garantir que as alterações de configuração não são revertidas pelo MIG, é importante usar os métodos descritos neste documento. Se trabalhar fora dos métodos do grupo para modificar as VMs de um MIG, o MIG pode ou não detetar que essas VMs já não estão a usar a configuração pretendida do grupo e pode ter resultados inesperados. Por exemplo, se eliminar ou atualizar uma VM num GIG através da API Instances em vez da API Instance Group Manager necessária, o GIG não tem conhecimento da sua intenção e, em qualquer altura no futuro, o GIG pode tentar recriar ou reverter automaticamente essa VM de acordo com a configuração do GIG.

Antes de começar

  • Reveja as limitações e, de seguida, crie um grupo.
  • 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.

    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. Depois de iniciar sessão, inicialize a CLI gcloud executando o seguinte comando: 

      gcloud init

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

O que é uma instância gerida?

Uma instância gerida é uma entidade de dados num GIG que contém o estado atual e o estado pretendido para uma instância de VM real.

O estado atual de uma instância gerida inclui os seguintes campos:

  • Estado do ciclo de vida da instância, por exemplo, RUNNING, STOPPING.
  • Ação atual executada pelo MIG numa instância, por exemplo: RESTARTING, VERIFYING, NONE.
  • Estado de saúde da instância: por exemplo, HEALTHY e UNHEALTHY.

O estado pretendido de uma instância gerida para uma instância de VM real inclui o seguinte:

  • Versão pretendida, ou seja, o nome da versão e o modelo de instância a usar para a instância.
  • Estado preservado dos itens (como discos ou metadados) a preservar.

Conforme mostrado na figura 1, para cada instância gerida num MIG, o MIG mantém uma VM real em funcionamento de acordo com a especificação da instância gerida.

Com base na sua configuração, o GIG gera automaticamente instâncias geridas, que correspondem a instâncias de VM reais que um GIG mantém em seu nome.

Figura 1. Relação entre instâncias geridas e VMs correspondentes.

Para ver as especificações de uma instância gerida, consulte o artigo Ver informações sobre as instâncias geridas num MIG.

Adicione instâncias a um MIG

Para adicionar mais instâncias a um MIG, pode fazer o seguinte:

Para verificar se as instâncias adicionadas recentemente estão em funcionamento, verifique o estado do grupo ou verifique o estado das instâncias geridas.

Defina manualmente o tamanho do MIG

Se um grupo de instâncias gerido ainda não estiver definido para ser dimensionado automaticamente, pode definir manualmente o tamanho do grupo para alterar o número de instâncias no grupo. Para mais informações, consulte o artigo Redimensionar manualmente um MIG.

Use pedidos de redimensionamento para criar VMs de uma só vez

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.

Use a escala automática para aplicações sem estado

Pode configurar grupos de instâncias geridos para adicionar ou remover automaticamente instâncias 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 é menor. Para mais informações sobre o dimensionamento automático do MIG, consulte o artigo Dimensionamento automático de grupos de instâncias.

Adicione instâncias com nomes específicos

Se a sua carga de trabalho ou sistema de orquestração exigir nomes de instâncias específicos, pode adicionar instâncias com esses nomes a um MIG existente. Os nomes que atribui a estas instâncias persistem se o MIG as recriar.

Com base na forma como quer adicionar instâncias com nomes específicos a um MIG, use um dos seguintes métodos:

Elimine instâncias de um MIG

Quando elimina instâncias geridas, o GIG reduz o targetSize do grupo e elimina as instâncias de VM correspondentes.

Se configurar um MIG com estado, o MIG elimina as configurações de estado preservadas das instâncias. O MIG também remove as instâncias de todos os grupos de destino dos quais são membros.

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.

Para eliminar uma instância gerida, pode:

Atualize a configuração da VM num MIG

Se precisar de alterar a configuração das VMs num GIG, por exemplo, para modificar o disco de arranque ou o tipo de máquina, adicionar discos ou alterar outras propriedades da VM, consulte o artigo Atualizar a configuração da VM num GIG.

Recrie instâncias num MIG

Use este método para atualizar as VMs selecionadas para que usem os componentes de configuração de VMs mais recentes do grupo. Se precisar de recriar todas as VMs num grupo de instâncias gerido, inicie uma atualização contínua em alternativa.

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.

Recrie instâncias de VMs selecionadas num grupo de instâncias geridas através da CLI gcloud, ou REST.

gcloud

Use o comando instance-groups managed recreate-instances.

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

REST

Na API, faça um pedido POST ao método regionInstanceGroupManagers.recreateInstances. Para um grupo de instâncias geridas zonal, use o método instanceGroupManagers.recreateInstances.

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

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

Depois de fazer um pedido para recriar instâncias de VM num grupo de instâncias gerido, as novas VMs são iniciadas assim que o sistema as puder aprovisionar. Este processo pode demorar um período significativo, consoante o número de instâncias que recria. Verifique o estado do grupo ou verifique o estado das instâncias geridas.

A operação de recriação preserva o nome da instância de VM, mas a data/hora de criação da instância pode não ser alterada. Para confirmar que a operação de recriação criou uma nova instância quando a data/hora de criação da instância não foi alterada, verifique a data/hora de criação do disco de arranque associado a essa instância.

Veja informações sobre instâncias num MIG

Consulte o artigo Ver informações sobre as instâncias geridas num MIG.

Configure instâncias com estado num MIG

Consulte o artigo Configurar MIGs com estado.

O que se segue?