Este documento descreve como criar um grupo gerenciado de instâncias (MIG) que preserva os dados em discos com um determinado nome de dispositivo para todas as VMs do MIG, mesmo no caso de recriação de VM, por exemplo, quando uma VM no MIG é reparada automaticamente, atualizada ou recriada. A preservação de discos é útil para determinadas cargas de trabalho, por exemplo, para bancos de dados ou aplicativos legados.
Além de preservar discos para todas as VMs do grupo, você também pode configurar um MIG com estado para o seguinte:
- Você pode adicionar e preservar discos específicos da instância.
- Você pode adicionar e preservar metadados específicos da instância.
- Você pode adicionar e preservar endereços IP.
Para obter mais informações, consulte a visão geral do MIG com estado .
Você também pode ler sobre outros cenários básicos para criar um MIG .
Antes de começar
- Crie um modelo de instância , necessário para criar um grupo de instâncias gerenciadas.
- 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
-
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.
- Set a default region and zone.
- Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, confirm that you have configured the gcloud CLI to use Workforce Identity Federation.
- Você não poderá usar o escalonamento automático se o seu MIG tiver configuração com estado.
- Se quiser usar atualizações contínuas automatizadas, você deverá definir o método de substituição como
RECREATE
. - Para MIGs regionais com estado, você deve desabilitar a redistribuição proativa (definir o tipo de redistribuição como
NONE
) para evitar a exclusão de instâncias com estado por meio da redistribuição automática entre zonas. - Se você usar uma configuração de todas as instâncias para substituir as propriedades do modelo de instância, não poderá especificar essas propriedades em nenhuma configuração por instância e ao mesmo tempo na configuração de todas as instâncias do grupo.
Acesse a página Grupos de instâncias .
As etapas restantes aparecem no console do Google Cloud.
- Clique
Criar grupo de instâncias . - Selecione o
Novo grupo gerenciado de instâncias (com estado) opção. - Atribua um nome e, opcionalmente, uma descrição ao seu grupo de instâncias.
- Escolha um modelo de instância para o grupo de instâncias ou crie um novo .
- No
Número de instâncias campo, especifique o número inicial de VMs necessárias neste grupo. - No
Configuração com estado seção, em Configuração do grupo , clique no disco que deseja tornar com estado e execute as etapas a seguir. - Na seção Stateful , selecione Sim .
- Na lista Na exclusão permanente da instância , escolha se deseja desanexar o disco ou excluir o disco ao excluir permanentemente a VM.
- Para salvar as configurações, clique em Concluído .
- Para criar o MIG, clique em
Criar . -
INSTANCE_GROUP_NAME
: o nome do grupo de instâncias gerenciadas a ser criado. -
INSTANCE_TEMPLATE
: o nome do modelo de instância a ser usado ao criar instâncias. Para um modelo de instância regional, você deve especificar o URL completo ou parcial do modelo. Um exemplo de URL completo éhttps://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/instanceTemplates/example-regional-instance-template
e um URL parcial éprojects/example-project/regions/us-central1/instanceTemplates/example-regional-instance-template
. -
SIZE
: o número inicial de VMs necessárias neste grupo. -
DEVICE_NAME
: o nome do dispositivo de um disco especificado no modelo de instância. DELETE_RULE
: um valor que prescreve o que deve acontecer a um disco com estado quando uma VM é excluída. As opções disponíveis são:-
never
: (Padrão.) Nunca exclua o disco; em vez disso, desconecte o disco quando sua VM for excluída. -
on-permanent-instance-deletion
: exclua o disco quando sua instância de VM for excluída permanentemente do grupo de instâncias, por exemplo, quando a instância gerenciada for excluída manualmente ou quando o tamanho do grupo diminuir.
Independentemente do valor da regra de exclusão, os discos com estado são sempre preservados nas operações de recuperação automática, atualização e recriação da VM.
-
-
PROJECT
: O ID do projeto para a solicitação. -
ZONE
: A zona onde o MIG está localizado (aplica-se a um MIG zonal).- Para um MIG regional, substitua
zones/ ZONE
porregions/ REGION
e especifique a região do MIG.
- Para um MIG regional, substitua
-
NAME
: O nome do MIG a ser criado. -
TEMPLATE
: O nome do modelo de instância a ser usado ao criar instâncias. -
SIZE
: O número inicial de instâncias necessárias neste grupo. -
DEVICE_NAME
: o nome do dispositivo de um disco especificado no modelo de instância. DELETE_RULE
: um valor que prescreve o que deve acontecer ao disco com estado quando a instância da VM for excluída. As opções disponíveis são:-
never
: (Padrão.) Nunca exclua o disco; desconecte o disco quando a VM for excluída. -
on_permanent_instance_deletion
: exclua o disco com estado quando sua VM for excluída permanentemente do grupo de instâncias, por exemplo, quando a instância gerenciada for excluída manualmente ou quando o tamanho do grupo diminuir.
Independentemente do valor da regra de exclusão, os discos com estado são sempre preservados nas operações de recuperação automática, atualização e recriação da instância.
-
- Saiba mais sobre MIGs com estado e quando usá-los.
- Saiba mais sobre como configurar discos com estado em MIGs .
- Saiba como funcionam os MIGs com estado .
- Saiba mais sobre como configurar MIGs com estado para discos , metadados e endereços IP .
Terraform
Para usar os exemplos do Terraform nesta página em um ambiente de desenvolvimento local, instale e inicialize a gcloud CLI e, em seguida, configure o Application Default Credentials com suas credenciais de usuário.
Confira mais informações em Set up authentication for a local development environment.
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.
Limitações
Um MIG com configuração com estado — um MIG com estado — tem as seguintes limitações:
Para ver a lista completa de limitações do MIG, que varia de acordo com a configuração usada, consulte Limitações do MIG .
Crie um MIG com discos com estado
Use o console do Google Cloud , a CLI gcloud , o Terraform ou o REST .
Console
gcloud
Para especificar quais discos do modelo de instância devem ter estado na criação do MIG, use a sinalização
--stateful-disk
com ogcloud compute instance-groups managed create
:gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \ --template INSTANCE_TEMPLATE \ --size SIZE \ --stateful-disk device-name=DEVICE_NAME[,auto-delete=DELETE_RULE]
Substitua o seguinte:
Terraforma
Se você ainda não criou um modelo de instância, que especifica o tipo de máquina, a imagem do disco de inicialização, a rede e outras propriedades de VM desejadas para cada VM em seu MIG, crie um modelo de instância .
Para especificar quais discos do modelo de instância devem ter estado na criação do MIG, inclua o bloco
stateful_disk
. O exemplo a seguir cria um MIG zonal com discos com estado. Para obter mais informações sobre o recurso usado no exemplo, consulte recursogoogle_compute_instance_group_manager
.Para saber como aplicar ou remover uma configuração do Terraform, consulte Comandos básicos do Terraform .
DESCANSAR
Para especificar quais discos do modelo de instância devem ter estado na criação do MIG, inclua-os no campo
statefulPolicy
no corpo da sua solicitação. Para um MIG zonal, use o métodoinstanceGroupManagers.insert
ou para um MIG regional, use o métodoregionInstanceGroupManagers.insert
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/instanceGroupManagers { "name": "NAME", "versions": [ { "instanceTemplate": "global/instanceTemplates/TEMPLATE" } ], "targetSize": SIZE, "statefulPolicy": { "preservedState": { "disks": { "DEVICE_NAME": {"autoDelete": "DELETE_RULE" }, "DEVICE_NAME": {"autoDelete": "DELETE_RULE" } } } } }
Substitua o seguinte:
O que vem a seguir
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-04-21 UTC.
-