Você pode melhorar o tempo de atividade e a resiliência de seus aplicativos com estado com grupos de instâncias gerenciadas com estado (MIGs com estado).
Ao criar uma configuração com estado , você pode preservar o estado exclusivo de cada uma das instâncias de máquina virtual (VM) do seu MIG, incluindo nome, discos persistentes e metadados, em eventos de reinicialização, recriação, recuperação automática ou atualização da máquina.
Esta página descreve maneiras de configurar MIGs com estado, juntamente com links para os guias de cada tarefa:
- Configurando e preservando nomes de instâncias
- Configurar e gerenciar discos permanentes com estado
- Configurando e gerenciando metadados com estado
- Configurando e gerenciando endereços IP com estado
Depois de criar ou atualizar uma configuração com estado, você poderá aplicá- la para torná-la efetiva, visualizar a configuração, bem como o estado preservado efetivo de cada VM ou removê-la se não precisar mais dela.
Se você tiver um aplicativo com estado em VMs autônomas (não gerenciadas) do Compute Engine, consulte também o guia para Migrar uma carga de trabalho existente para um MIG com estado .
Antes de começar
- Revise Quando usar MIGs com estado
- Revise o que torna um MIG com estado
- Para obter mais informações, consulte Como funcionam os MIGs com estado
- 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.
- 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.
Um MIG regional com estado não orquestra automaticamente o failover entre zonas. Ao usar um MIG regional, você pode tornar seu aplicativo com estado resiliente a falhas zonais, implantando réplicas redundantes em diversas zonas e contando com a funcionalidade de replicação de dados do seu aplicativo.
Quando você exclui permanentemente uma instância (manualmente ou redimensionando), o MIG não preserva os metadados com estado da instância.
- Migração de VMs autônomas existentes para um MIG com estado para se beneficiar da recuperação e atualização automáticas, preservando seus nomes.
- Implantar arquiteturas onde as dependências externas dependem de nomes de VM específicos, por exemplo, uma VM primária que mantém um registro de nós de trabalho com base em nomes pré-configurados ou usando um padrão de nomenclatura especial.
- Implantar configurações legadas que exigem nomes de VM específicos, por exemplo, porque os nomes são codificados permanentemente.
- Aplique a configuração com estado para que ela entre em vigor.
- Visualize a configuração com estado, bem como o estado efetivamente preservado de suas instâncias gerenciadas.
- Remova a configuração com estado.
- Crie VMs com nomes específicos em um MIG.
- Configure discos permanentes com estado para todas as VMs ou para VMs específicas em um MIG.
- Configure metadados com estado para VMs em um MIG.
- Configurar endereços IP com estado para todas as VMs ou para VMs específicas em um MIG.
- Aplique, visualize ou remova sua configuração com estado.
- Saiba mais sobre MIGs e como trabalhar com instâncias gerenciadas .
- Configurando e preservando nomes de instâncias
- Configurar e gerenciar discos permanentes com estado
- Configurando e gerenciando metadados com estado
- Configurando e gerenciando endereços IP com estado
- Revise Quando usar MIGs com estado
- Revise o que torna um MIG com estado
- Para obter mais informações, consulte Como funcionam os MIGs com estado
- 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.
- 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.
Um MIG regional com estado não orquestra automaticamente o failover entre zonas. Ao usar um MIG regional, você pode tornar seu aplicativo com estado resiliente a falhas zonais, implantando réplicas redundantes em diversas zonas e contando com a funcionalidade de replicação de dados do seu aplicativo.
Quando você exclui permanentemente uma instância (manualmente ou redimensionando), o MIG não preserva os metadados com estado da instância.
- Migração de VMs autônomas existentes para um MIG com estado para se beneficiar da recuperação e atualização automáticas, preservando seus nomes.
- Implantar arquiteturas onde as dependências externas dependem de nomes de VM específicos, por exemplo, uma VM primária que mantém um registro de nós de trabalho com base em nomes pré-configurados ou usando um padrão de nomenclatura especial.
- Implantar configurações legadas que exigem nomes de VM específicos, por exemplo, porque os nomes são codificados permanentemente.
- Aplique a configuração com estado para que ela entre em vigor.
- Visualize a configuração com estado, bem como o estado efetivamente preservado de suas instâncias gerenciadas.
- Remova a configuração com estado.
- Crie VMs com nomes específicos em um MIG.
- Configure discos permanentes com estado para todas as VMs ou para VMs específicas em um MIG.
- Configure metadados com estado para VMs em um MIG.
- Configurar endereços IP com estado para todas as VMs ou para VMs específicas em um MIG.
- Aplique, visualize ou remova sua configuração com estado.
- Saiba mais sobre MIGs e como trabalhar com instâncias gerenciadas .
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:
Configurando e preservando nomes de instâncias
Um MIG sempre preserva os nomes de suas instâncias de VM, a menos que você exclua permanentemente as instâncias diminuindo o tamanho do grupo ou executando uma atualização contínua que substitua as instâncias existentes por novas.
Se quiser preservar os nomes das instâncias durante as atualizações, defina o método de substituição da atualização como
RECREATE
na política de atualização do grupo.Você pode especificar nomes personalizados criando instâncias manualmente ou pode permitir que o MIG gere automaticamente nomes para suas VMs.
Definir nomes de VM personalizados é útil para:
Em todos os outros casos, você pode permitir que o MIG gere automaticamente nomes de VM usando o nome da instância base mais um sufixo aleatório.
Configurar e gerenciar discos permanentes com estado
Configurar discos permanentes para que tenham estado permite que você se beneficie da recuperação automática de VM e das atualizações controladas , preservando o estado dos discos. Para obter mais informações, consulte os casos de uso de MIGs com estado.
Para obter instruções, consulte Configuração de discos persistentes com estado .
Configurando metadados com estado
Você pode usar metadados de instância para definir propriedades e se comunicar com seus aplicativos por meio do servidor de metadados. Por exemplo, você pode usar metadados para configurar a identidade da VM, variáveis de ambiente, informações sobre a arquitetura do cluster ou intervalo de dados pelo qual esta VM é responsável.
Ao usar metadados com estado, você garante que os metadados específicos da instância sejam preservados em eventos de recuperação automática, atualização e recriação da instância.
Para obter instruções, consulte Configurando metadados com estado .
Configurando e gerenciando endereços IP com estado
Você pode configurar um grupo gerenciado de instâncias (MIG) para preservar endereços IP em eventos de recuperação automática, atualização e recreação de instâncias, declarando-os com estado. Os endereços IP internos e externos podem ser preservados. Você pode configurar endereços IP para serem atribuídos automaticamente ou atribuir endereços IP específicos a cada instância de VM em um MIG.
Para obter instruções, consulte Configurando endereços IP com estado .
Aplicando, visualizando e removendo configuração com estado
Depois de configurar um MIG para ter estado, você poderá:
Para obter instruções, consulte Aplicando, visualizando e removendo configurações com estado .
Opinião
Queremos saber mais sobre seus casos de uso, desafios e feedback sobre MIGs com estado. Compartilhe seus comentários com nossa equipe em mig-discuss@google.com .
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.
-
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:
Configurando e preservando nomes de instâncias
Um MIG sempre preserva os nomes de suas instâncias de VM, a menos que você exclua permanentemente as instâncias diminuindo o tamanho do grupo ou executando uma atualização contínua que substitua as instâncias existentes por novas.
Se quiser preservar os nomes das instâncias durante as atualizações, defina o método de substituição da atualização como
RECREATE
na política de atualização do grupo.Você pode especificar nomes personalizados criando instâncias manualmente ou pode permitir que o MIG gere automaticamente nomes para suas VMs.
Definir nomes de VM personalizados é útil para:
Em todos os outros casos, você pode permitir que o MIG gere automaticamente nomes de VM usando o nome da instância base mais um sufixo aleatório.
Configurar e gerenciar discos permanentes com estado
Configurar discos permanentes para que tenham estado permite que você se beneficie da recuperação automática de VM e das atualizações controladas , preservando o estado dos discos. Para obter mais informações, consulte os casos de uso de MIGs com estado.
Para obter instruções, consulte Configuração de discos persistentes com estado .
Configurando metadados com estado
Você pode usar metadados de instância para definir propriedades e se comunicar com seus aplicativos por meio do servidor de metadados. Por exemplo, você pode usar metadados para configurar a identidade da VM, variáveis de ambiente, informações sobre a arquitetura do cluster ou intervalo de dados pelo qual esta VM é responsável.
Ao usar metadados com estado, você garante que os metadados específicos da instância sejam preservados em eventos de recuperação automática, atualização e recriação da instância.
Para obter instruções, consulte Configurando metadados com estado .
Configurando e gerenciando endereços IP com estado
Você pode configurar um grupo gerenciado de instâncias (MIG) para preservar endereços IP em eventos de recuperação automática, atualização e recreação de instâncias, declarando-os com estado. Os endereços IP internos e externos podem ser preservados. Você pode configurar endereços IP para serem atribuídos automaticamente ou atribuir endereços IP específicos a cada instância de VM em um MIG.
Para obter instruções, consulte Configurando endereços IP com estado .
Aplicando, visualizando e removendo configuração com estado
Depois de configurar um MIG para ter estado, você poderá:
Para obter instruções, consulte Aplicando, visualizando e removendo configurações com estado .
Opinião
Queremos saber mais sobre seus casos de uso, desafios e feedback sobre MIGs com estado. Compartilhe seus comentários com nossa equipe em mig-discuss@google.com .
O que vem a seguir
Você pode melhorar o tempo de atividade e a resiliência de seus aplicativos com estado com grupos de instâncias gerenciadas com estado (MIGs com estado).
Ao criar uma configuração com estado , você pode preservar o estado exclusivo de cada uma das instâncias de máquina virtual (VM) do seu MIG, incluindo nome, discos persistentes e metadados, em eventos de reinicialização, recriação, recuperação automática ou atualização da máquina.
Esta página descreve maneiras de configurar MIGs com estado, juntamente com links para os guias de cada tarefa:
Depois de criar ou atualizar uma configuração com estado, você poderá aplicá- la para torná-la efetiva, visualizar a configuração, bem como o estado preservado efetivo de cada VM ou removê-la se não precisar mais dela.
Se você tiver um aplicativo com estado em VMs autônomas (não gerenciadas) do Compute Engine, consulte também o guia para Migrar uma carga de trabalho existente para um MIG com estado .
Antes de começar
-