Trabalhar com instâncias gerenciadas

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

Cada instância gerenciada é uma entidade de dados que representa o estado pretendido para uma instância real de máquina virtual (VM) em um MIG.

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

Para garantir que as alterações na 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 você poderá obter 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 do gerenciador de grupo de instâncias , o MIG não terá conhecimento de sua intenção e, a qualquer momento no futuro, o MIG poderá tentar recriar ou reverter automaticamente essa VM de acordo com a configuração do MIG.

Antes de começar

  • Revise as limitações e crie um grupo.
  • 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.

O que é uma instância gerenciada?

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

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

  • Status do ciclo de vida da instância — por exemplo, RUNNING , STOPPING .
  • Ação atual executada pelo MIG em uma instância — por exemplo: RESTARTING , VERIFYING , NONE .
  • Estado de integridade da instância — por exemplo, HEALTHY , 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.

Conforme mostrado na figura 1, para cada instância gerenciada em um MIG, o MIG mantém uma VM real em funcionamento 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 às instâncias reais de VM que um MIG mantém em seu nome.

Figura 1. Relacionamento entre instâncias gerenciadas e VMs correspondentes.

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

Adicionando instâncias a um MIG

Para adicionar mais instâncias a um MIG, você pode:

Para verificar se as instâncias recém-adicionadas estão funcionando, verifique o status do grupo ou verifique o status das instâncias gerenciadas .

Redimensionamento manual

Se um grupo de instâncias gerenciadas ainda não estiver configurado para escalar automaticamente, você poderá definir o tamanho do grupo manualmente para alterar o número de instâncias no grupo. Consulte Redimensionando manualmente um MIG .

Escalonamento automático

Você pode configurar grupos de instâncias gerenciadas para adicionar ou remover instâncias automaticamente com base em suas cargas de trabalho. Seus aplicativos podem lidar com aumentos de tráfego e você pode reduzir seus custos quando a necessidade de recursos de computação for menor. Para obter mais informações sobre como dimensionar automaticamente seu MIG, consulte Dimensionamento automático de grupos de instâncias .

Adicionando 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 existente. Os nomes atribuídos a essas instâncias gerenciadas persistirão se o MIG recriar a VM. Para obter mais informações, consulte Criando instâncias com nomes específicos em MIGs

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

Excluindo 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 excluirá as configurações de estado preservadas das instâncias. O MIG também remove as instâncias de quaisquer pools de destino dos quais sejam membros.

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

Para excluir uma instância gerenciada, você pode:

Atualizando 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 Atualizando a configuração da VM em um MIG .

Recriando instâncias em um MIG

Use este método para atualizar 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 habilitou a drenagem da conexão , poderá levar até 60 segundos adicionais após o término da duração da drenagem da conexão antes que a instância de VM seja removida ou excluída.

Recrie instâncias de VM selecionadas no grupo de instâncias gerenciadas usando a CLI gcloud ou REST .

gcloud

Use o comando de 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]

DESCANSAR

Na API, faça uma solicitação POST para o método regionInstanceGroupManagers.recreateInstances . Para um grupo de instâncias gerenciadas 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 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 levar um tempo significativo, dependendo do número de instâncias recriadas. Verifique o status do grupo ou verifique o status 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 se 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.

Visualizando informações sobre instâncias em um MIG

Consulte Visualização de informações sobre as instâncias gerenciadas em um MIG .

Configurando instâncias com estado em um MIG

Consulte Configurando MIGs com estado .

O que vem a seguir