Trabalhe com instâncias gerenciadas

Um grupo gerenciado de instâncias cria cada uma das instâncias gerenciadas com base nos componentes de configuração usados: modelo de instância, configuração de todas as instâncias opcional e configuração com estado opcional.

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 para modificar as VMs de um MIG, o MIG poderá ou não detectar que essas VMs não estão mais usando a configuração pretendida do grupo, e talvez ocorram resultados inesperados. Por exemplo, se você excluir ou atualizar uma VM em um MIG usando a API de instâncias em vez da API necessária de gerenciador de grupo de instâncias, o MIG não vai estar ciente do seu intent e, a qualquer momento futuro, o MIG poderá tentar automaticamente recriar ou reverter essa VM de acordo com a configuração dele.

Antes de começar

  • Analise as limitações e crie um grupo.
  • 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 da seguinte maneira.

    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.

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 os componentes de configuração de VM mais recentes do grupo. 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 gcloud CLI ou a 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 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.

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

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