Trabalhe com instâncias gerenciadas

Um grupo de instâncias gerenciadas (MIG, na sigla em inglês) cria cada uma das instâncias gerenciadas com base nos modelos de instância e em uma configuração com estado opcional que você especificar. Cada instância gerenciada é uma entidade de dados que representa o estado pretendido para uma instância de máquina virtual (VM) real em um MIG.

Leia este documento para saber como trabalhar de maneira confiável com as instâncias gerenciadas em um MIG. Por exemplo, talvez seja necessário adicionar, remover, atualizar ou receber informações sobre uma instância específica.

Para garantir que suas alterações de configuração não sejam revertidas pelo MIG, é importante usar os métodos descritos neste documento. Se você trabalhar fora dos métodos do grupo, o MIG detectará alterações e poderá tentar reparar o grupo. Por exemplo, se você excluir uma instância em um grupo, o MIG poderá recriá-la automaticamente de acordo com a configuração do MIG.

Antes de começar

O que é uma instância gerenciada?

Uma instância gerenciada é uma entidade de dados dentro de uma MIG que contém o status atual e o estado pretendido de uma instância de VM real.

O status atual de uma instância gerenciada inclui os campos a seguir:

  • Status ciclo de vida da instância, por exemplo, RUNNING e STOPPING.
  • Ação atual realizada pelo MIG em uma instância, por exemplo: RESTARTING, VERIFYING e NONE.
  • Estado de integridade da instância, por exemplo, HEALTHY e UNHEALTHY.

O estado pretendido de uma instância gerenciada 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 serem usados para a instância.
  • Estado preservado de itens (como discos ou metadados) a serem preservados.

Como mostrado na figura 1, para cada instância gerenciada em um MIG, o MIG mantém uma VM real funcionando de acordo com a especificação da instância gerenciada.

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

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

Para visualizar as especificações de uma instância gerenciada, consulte Como receber informações sobre as instâncias gerenciadas em um MIG.

Como adicionar instâncias a um MIG

Para adicionar mais instâncias a um MIG, é possível:

Para verificar se as instâncias adicionadas recentemente estão em execução, verifique o status do grupo ou das instâncias gerenciadas.

Redimensionamento manual

Se um grupo de instâncias gerenciadas ainda não estiver definido para escalonar automaticamente, é possível definir o tamanho do grupo manualmente para alterar o número de instâncias no grupo. Consulte Como redimensionar manualmente um MIG.

Escalonamento automático

Configure grupos de instâncias gerenciadas para adicionar ou remover instâncias automaticamente com base nas cargas de trabalho delas. Os aplicativos lidam de maneira suave com aumentos no tráfego, e é possível reduzir os custos quando a necessidade de recursos de computação for menor. Para saber mais sobre como escalonar seu MIG automaticamente, consulte Como fazer escalonamento automático de grupos de instâncias.

Como criar instâncias com nomes específicos

Se você tiver um sistema que depende de nomes específicos, poderá adicionar VMs com esses nomes a um MIG atual. Os nomes que você atribuir a essas instâncias gerenciadas persistirão se o MIG recriar a VM. Para mais informações, consulte Como criar instâncias com nomes específicos em MIGs.

Para ver mais informações sobre como preservar o estado de instâncias de MIG, consulte MIGs com estado.

Como excluir instâncias de um MIG

Quando você exclui instâncias gerenciadas, o MIG reduz o targetSize do grupo e exclui as instâncias de VM correspondentes.

Se você configurar um MIG com estado, o MIG exclui as configurações de estado preservadas das instâncias. O MIG também remove as instâncias dos pools de destino que as contêm.

Se o grupo fizer parte de um serviço de back-end que tenha ativado a diminuição da conexão, poderá levar até 60 segundos após a duração da diminuição da conexão antes que a instância de VM seja removida ou excluída.

Para excluir uma instância gerenciada, é possível:

Como atualizar a configuração da VM em um MIG

Se você precisar alterar a configuração das VMs em um MIG, por exemplo, para modificar o disco de inicialização ou o tipo de máquina, adicionar discos ou alterar outras propriedades da VM, consulte Como atualizar a configuração da VM em um MIG.

Como recriar instâncias em um MIG

Use esse método para atualizar as VMs selecionadas para que elas usem o modelo de instância mais recente e a configuração com estado, se houver. Se você precisar recriar todas as VMs em um grupo de instâncias gerenciadas, inicie uma atualização contínua.

Se o grupo fizer parte de um serviço de back-end que tenha ativado a diminuição da conexão, poderá levar até 60 segundos após a duração da diminuição da conexão antes que a instância de VM seja removida ou excluída.

Recrie as instâncias de VM selecionadas no grupo gerenciado de instâncias usando a CLI gcloud ou a API.

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]

API

Na API, faça uma solicitação POST para o método regionInstanceGroupManagers.recreateInstances. Para grupos de instâncias gerenciadas zonais, 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 que você fizer uma solicitação para recriar instâncias de VM em um grupo de instâncias gerenciadas, as novas VMs serão iniciadas assim que o sistema puder provisioná-las. Esse processo pode demorar significativamente dependendo do número de instâncias recriadas. Verifique o status do grupo ou das instâncias gerenciadas.

Como ver informações sobre instâncias em um MIG

Consulte Como ver informações sobre as instâncias gerenciadas em um MIG.

Como configurar instâncias com estado em um MIG

Consulte Como configurar MIGs com estado.

A seguir