Este documento descreve como mover uma instância de máquina virtual (VM) entre zonas ou regiões.
Antes de começar
- Leia a documentação das zonas .
- 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:
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.
- 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.
- 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.
- 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.
Cota do projeto. Seu projeto deve ter cota suficiente para fazer o seguinte:
- Crie novos instantâneos.
- Promova quaisquer endereços IP externos efêmeros.
Crie novas VMs e discos na sua região de destino.
Por exemplo, se você tiver três discos anexados à VM que deseja mover, precisará de cota suficiente para criar três snapshots temporários de discos permanentes e três novos discos. Depois de criar seus novos discos, você poderá excluir seus instantâneos temporários.
Verifique a página Cotas para garantir que você tenha cota suficiente para os recursos anteriores. Para obter mais informações, consulte Noções básicas sobre cotas .
Discos permanentes. Os discos permanentes anexados à VM que você deseja mover não estão anexados a outras VMs.
SSDs locais. Os SSDs locais destinam-se ao armazenamento temporário e os dados nos SSDs locais não são preservados através de terminações manuais de VM. Se você precisar preservar os dados SSD locais, replique-os usando uma opção de armazenamento durável, como discos permanentes.
GPU. Se a sua VM incluir GPUs, verifique se as GPUs que você deseja usar estão disponíveis na zona de destino da VM. Para ver uma lista de GPUs e as zonas em que elas estão disponíveis, consulte GPUs no Compute Engine .
Sub-rede. Se quiser mover sua VM entre regiões, como entre
us-west1-a
easia-south1-b
, e sua VM pertencer a uma sub-rede, você deverá selecionar uma nova sub-rede para sua VM. Para obter instruções sobre como criar sub-redes, consulte Adicionando sub-redes .- URL do disco de origem de uma VM
- URL do tipo de máquina de uma VM
- URLs de autolink
- URLs de zona
- URLs de tipo de disco
- Quaisquer URLs de VMs listadas na lista de
users[]
de um disco - Crie uma imagem de máquina da sua VM de origem.
- Crie uma VM a partir da imagem da máquina em uma zona ou região diferente.
Identifique os discos associados à VM que você deseja mover:
gcloud compute instances describe myinstance --format="list(name,status,disks)"
Neste exemplo, você encontra os dois discos associados a seguir para a VM
myinstance
:- Um disco de inicialização chamado
mybootdisk
- Um disco de dados chamado
mydatadisk
- Um disco de inicialização chamado
Defina o estado de exclusão automática de
mybootdisk
emydatadisk
comofalse
para garantir que os discos não sejam excluídos automaticamente quando a VM for excluída.gcloud compute instances set-disk-auto-delete myinstance --zone europe-west1-c \ --disk mybootdisk --no-auto-delete
Se o estado foi atualizado,
gcloud compute
retornará a respostaUpdated [...]
. Se o estado de exclusão automática já estiver definido como falso,gcloud compute
retornará:No change requested; skipping update for [myinstance].
(Opcional) Salve os metadados da VM.
Quando você exclui sua VM, os metadados da VM também são removidos. Você pode salvar essas informações em um arquivo separado e reaplicar os metadados da VM à nova VM.
Descreva os metadados da sua VM da seguinte forma:
gcloud compute instances describe myinstance --zone europe-west1-c
Salve o conteúdo em um arquivo separado.
Crie backups dos seus dados usando snapshots de discos permanentes.
Como precaução, crie backups dos seus dados enquanto os discos permanentes ainda estão anexados à VM usando snapshots de discos permanentes. Antes de criar um snapshot, certifique-se de que ele seja consistente com o estado do disco permanente seguindo as práticas recomendadas para snapshots .
Depois de limpar os buffers de disco, crie os snapshots:
gcloud compute disks snapshot mybootdisk mydatadisk \ --snapshot-names backup-mybootsnapshot,backup-mydatasnapshot \ --zone europe-west1-c
Para verificar se o snapshot foi criado, execute
gcloud compute snapshots list
.(Opcional) Se você estiver movendo uma VM entre zonas dentro da mesma região e quiser preservar seu endereço IP interno ou externo efêmero, promova o endereço IP interno ou externo para um endereço IP estático, que poderá ser reutilizado posteriormente.
Exclua sua VM.
Excluir sua VM a desliga de forma limpa e desanexa todos os discos permanentes.
gcloud compute instances delete myinstance --zone europe-west1-c
gcloud
solicita que você confirme a exclusão:The following VMs are deleted. Any attached disks configured to be auto-deleted are deleted unless they are attached to any other VMs or the `--keep-disks` flag is given and specifies them for keeping. Deleting a disk is irreversible and any data on the disk is lost. — [myinstance] in [europe-west1-c]
Do you want to continue (Y/n)?
Como você desativou o estado de exclusão automática dos discos anteriormente neste processo, insira Y para continuar e ignore o aviso.
Em seguida, crie outro instantâneo do disco de inicialização e do disco de dados.
gcloud compute disks snapshot mybootdisk mydatadisk \ --snapshot-names mybootsnapshot,mydatasnapshot \ --zone europe-west1-c
Created [.../mydatasnapshot]. Created [.../mybootsnapshot].
(Opcional) Exclua seus discos permanentes.
Se você planeja reutilizar os nomes dos discos permanentes para os novos discos, deverá excluir os discos existentes para liberar os nomes. Excluir seus discos também economiza custos de armazenamento em disco persistente.
Se você não planeja reutilizar os mesmos nomes de disco, não será necessário excluí-los.
gcloud compute disks delete mybootdisk mydatadisk --zone europe-west1-c
Crie novos discos permanentes em
us-west1-b
com base nos snapshots que você criou. Primeiro crie o disco de inicialização.gcloud compute disks create mybootdiskb --source-snapshot mybootsnapshot \ --zone us-west1-b
Created [.../mybootdiskb]. NAME ZONE SIZE_GB TYPE STATUS mybootdiskb us-west1-b 100 pd-standard READY
Em seguida, crie o disco de dados.
gcloud compute disks create mydatadiskb --source-snapshot mydatasnapshot \ --zone us-west1-b
Created [.../mydatadiskb]. NAME ZONE SIZE_GB TYPE STATUS mydatadiskb us-west1-b 4000 pd-standard READY
Recrie sua VM em
us-west1-b
.Se você optou por salvar os metadados da VM em um arquivo, por exemplo
myinstance.describe
, poderá usá-lo para definir os mesmos metadados na sua VM.Se sua VM tiver um endereço IP externo estático, você poderá reatribuir esse endereço à sua nova VM especificando a opção
--address [ADDRESS]
. Se você estiver movendo uma VM entre regiões, deverá escolher um endereço IP externo diferente para a nova instância de VM.Se sua VM tiver um endereço IP interno estático, você poderá reatribuir esse endereço à sua nova VM especificando a opção
--private-network-ip ADDRESS
. Se você estiver movendo uma VM entre regiões, deverá escolher um endereço IP interno diferente para a nova instância de VM.Se sua VM incluiu GPUs, adicione GPUs à VM usando a opção
--accelerator
.Se a VM usar uma sub-rede específica, adicione o sinalizador
--subnet [SUBNET_NAME]
.
Para obter uma lista completa de sinalizações adicionais, consulte gcloud computing instances create .
gcloud compute instances create myinstanceb --machine-type n1-standard-4 \ --zone us-west1-b \ --disk name=mybootdiskb,boot=yes,mode=rw \ --disk name=mydatadiskb,mode=rw
Created [.../myinstanceb]. NAME ZONE MACHINE_TYPE INTERNAL_IP EXTERNAL_IP STATUS myinstanceb us-west1-b n1-standard-4 10.240.173.229 146.148.112.106 RUNNING
(Opcional) Exclua os snapshots do disco permanente.
Depois de confirmar que suas máquinas virtuais foram movidas, economize nos custos de armazenamento excluindo os instantâneos temporários que você criou.
gcloud compute snapshots delete mybootsnapshot mydatasnapshot
Se você não precisar mais dos seus snapshots de backup, exclua-os também:
gcloud compute snapshots delete backup-mybootsnapshot backup-mydatasnapshot
Obtenha os detalhes da VM e identifique os discos anexados à VM.
Defina o estado de exclusão automática do disco de inicialização e do disco de dados como
false
para garantir que os discos não sejam excluídos automaticamente quando a VM for excluída.Crie backups dos seus dados usando snapshots de discos permanentes.
Como precaução, crie backups dos seus dados enquanto os discos permanentes ainda estão anexados à VM usando snapshots de discos persistentes. Antes de criar um snapshot, certifique-se de que ele seja consistente com o estado do disco permanente seguindo as práticas recomendadas para snapshots .
Depois de limpar os buffers de disco, crie os snapshots:
Exclua sua VM da zona de origem.
Em seguida, crie outro instantâneo do disco de inicialização e dos discos de dados.
(Opcional) Exclua seus discos permanentes.
Se você planeja reutilizar os nomes dos discos permanentes para os novos discos, deverá excluir os discos existentes para liberar os nomes. Excluir seus discos também economiza custos de armazenamento em disco persistente.
Se você não planeja reutilizar os mesmos nomes de disco, não será necessário excluí-los.
Crie novos discos permanentes na zona de destino a partir dos snapshots que você criou. Primeiro crie o disco de inicialização e depois os discos de dados.
Recrie sua VM com os novos discos na zona de destino.
(Opcional) Exclua os instantâneos de disco temporários. Depois de confirmar que suas máquinas virtuais foram movidas, economize nos custos de armazenamento excluindo os instantâneos temporários que você criou.
Obtenha os detalhes da VM e identifique os discos anexados à VM.
Defina o estado de exclusão automática do disco de inicialização e do disco de dados como
false
para garantir que os discos não sejam excluídos automaticamente quando a VM for excluída.Crie backups dos seus dados usando snapshots de discos permanentes.
Como precaução, crie backups dos seus dados enquanto os discos permanentes ainda estão anexados à VM usando snapshots de discos persistentes. Antes de criar um snapshot, certifique-se de que ele seja consistente com o estado do disco permanente seguindo as práticas recomendadas para snapshots .
Depois de limpar os buffers de disco, crie os snapshots:
Exclua sua VM da zona de origem.
Em seguida, crie outro instantâneo do disco de inicialização e dos discos de dados.
(Opcional) Exclua seus discos permanentes.
Se você planeja reutilizar os nomes dos discos permanentes para os novos discos, deverá excluir os discos existentes para liberar os nomes. Excluir seus discos também economiza custos de armazenamento em disco persistente.
Se você não planeja reutilizar os mesmos nomes de disco, não será necessário excluí-los.
Crie novos discos permanentes na zona de destino a partir dos snapshots que você criou. Primeiro crie o disco de inicialização e depois os discos de dados.
Recrie sua VM com os novos discos na zona de destino.
(Opcional) Exclua os instantâneos de disco temporários. Depois de confirmar que suas máquinas virtuais foram movidas, economize nos custos de armazenamento excluindo os instantâneos temporários que você criou.
Obtenha os detalhes da VM e identifique os discos anexados à VM.
Defina o estado de exclusão automática do disco de inicialização e do disco de dados como
false
para garantir que os discos não sejam excluídos automaticamente quando a VM for excluída.Crie backups dos seus dados usando snapshots de discos permanentes.
Como precaução, crie backups dos seus dados enquanto os discos permanentes ainda estão anexados à VM usando snapshots de discos permanentes. Antes de criar um snapshot, certifique-se de que ele seja consistente com o estado do disco permanente seguindo as práticas recomendadas para snapshots .
Depois de limpar os buffers de disco, crie os snapshots:
Exclua sua VM da zona de origem.
Em seguida, crie outro instantâneo do disco de inicialização e dos discos de dados.
(Opcional) Exclua seus discos permanentes.
Se você planeja reutilizar os nomes dos discos permanentes para os novos discos, deverá excluir os discos existentes para liberar os nomes. Excluir seus discos também economiza custos de armazenamento em disco persistente.
Se você não planeja reutilizar os mesmos nomes de disco, não será necessário excluí-los.
Crie novos discos permanentes na zona de destino a partir dos snapshots que você criou. Primeiro crie o disco de inicialização e depois os discos de dados.
Recrie sua VM com os novos discos na zona de destino.
(Opcional) Exclua os instantâneos de disco temporários. Depois de confirmar que suas máquinas virtuais foram movidas, economize nos custos de armazenamento excluindo os instantâneos temporários que você criou.
Obtenha os detalhes da VM e identifique os discos anexados à VM.
Defina o estado de exclusão automática do disco de inicialização e do disco de dados como
false
para garantir que os discos não sejam excluídos automaticamente quando a VM for excluída.Crie backups dos seus dados usando snapshots de discos permanentes.
Como precaução, crie backups dos seus dados enquanto os discos permanentes ainda estão anexados à VM usando snapshots de discos persistentes. Antes de criar um snapshot, certifique-se de que ele seja consistente com o estado do disco permanente seguindo as práticas recomendadas para snapshots .
Depois de limpar os buffers de disco, crie os snapshots:
Exclua sua VM da zona de origem.
Em seguida, crie outro instantâneo do disco de inicialização e dos discos de dados.
(Opcional) Exclua seus discos permanentes.
Se você planeja reutilizar os nomes dos discos permanentes para os novos discos, deverá excluir os discos existentes para liberar os nomes. Excluir seus discos também economiza custos de armazenamento em disco persistente.
Se você não planeja reutilizar os mesmos nomes de disco, não será necessário excluí-los.
Crie novos discos permanentes na zona de destino a partir dos snapshots que você criou. Primeiro crie o disco de inicialização e depois os discos de dados.
Recrie sua VM com os novos discos na zona de destino.
(Opcional) Exclua os instantâneos de disco temporários. Depois de confirmar que suas máquinas virtuais foram movidas, economize nos custos de armazenamento excluindo os instantâneos temporários que você criou.
- Saiba como alterar a zona/região padrão do seu projeto.
- Saiba mais sobre migração em tempo real .
- Verifique o status de uma VM.
- Saiba mais sobre a migração de VMs para o Compute Engine .
Go
Para usar os exemplos Go desta página em um ambiente de desenvolvimento local, instale e inicialize o gcloud CLI e e configure o Application Default Credentials com suas credenciais de usuário.
Confira mais informações em Set up authentication for a local development environment.
Java
Para usar os exemplos Java desta página em um ambiente de desenvolvimento local, instale e inicialize o gcloud CLI e e configure o Application Default Credentials com suas credenciais de usuário.
Confira mais informações em Set up authentication for a local development environment.
Node.js
Para usar os exemplos Node.js desta página em um ambiente de desenvolvimento local, instale e inicialize o gcloud CLI e e configure o Application Default Credentials com suas credenciais de usuário.
Confira mais informações em Set up authentication for a local development environment.
Python
Para usar os exemplos Python desta página em um ambiente de desenvolvimento local, instale e inicialize o gcloud CLI e e configure o Application Default Credentials com suas credenciais de usuário.
Confira mais informações em Set up authentication for a local development environment.
Requisitos
Esta seção lista os requisitos para mover uma VM entre zonas e regiões:
Limitação
Se você mover uma VM entre regiões, não poderá preservar o endereço IP interno ou externo efêmero da VM. Você deve escolher um novo endereço IP ao recriar a VM.
Propriedades de recursos
Para mover sua VM, você deve desligá-la, movê-la para a zona ou região de destino e reiniciá-la. Depois de mover a VM, atualize todas as referências que você tiver ao recurso original, como quaisquer VMs de destino ou pools de destino que apontem para a VM anterior.
Durante a movimentação, algumas propriedades geradas pelo servidor da sua VM e dos discos são alteradas.
Propriedades que mudam para VMs
A tabela a seguir descreve propriedades que mudam para VMs:
Nome da propriedade Mudanças Endereço IP interno Geralmente é atribuído um novo endereço IP interno, mas a VM pode manter o endereço IP interno original. Endereço IP externo Se a VM estiver se movendo entre zonas na mesma região , o endereço IP externo permanecerá o mesmo. Caso contrário, escolha um endereço IP externo diferente para a instância de VM. Plataforma CPU Dependendo da plataforma de CPU disponível na sua zona de destino, sua VM poderá ter uma plataforma de CPU diferente após ter sido movida. Para obter uma lista completa de plataformas de CPU em cada zona, consulte Regiões e zonas disponíveis . Rede/sub-rede Se sua VM pertencer a uma sub-rede e você estiver movendo uma VM entre regiões, deverá escolher uma nova sub-rede para sua VM. As VMs que se movem entre zonas na mesma região mantêm a mesma sub-rede. Propriedades que mudam para discos
A tabela a seguir descreve as propriedades que mudam para discos:
Nome da propriedade Mudanças Instantâneo de origem A captura instantânea de origem do novo disco é definida como a captura instantânea temporária criada durante a movimentação. ID do instantâneo de origem O ID do snapshot de origem é definido como o ID do snapshot temporário. Imagem de origem O campo da imagem de origem está vazio. ID da imagem O ID da imagem está vazio. Último carimbo de data/hora desanexado O último carimbo de data/hora desanexado está vazio. Último carimbo de data/hora anexado O último carimbo de data/hora anexado muda para o carimbo de data/hora quando o novo disco foi anexado à nova instância. Propriedades alteradas para VMs e discos
A tabela a seguir descreve propriedades que mudam tanto para VMs quanto para discos:
Nome da propriedade Mudanças EU IA Um novo ID de recurso é gerado. Carimbo de data e hora de criação Um novo carimbo de data/hora de criação é gerado. URLs de recursos de zona Todos os URLs de recursos de zona são alterados para refletir a zona de destino. A lista a seguir mostra as URLs de recursos que mudam: Mova uma VM entre zonas ou regiões
Para mover uma VM entre zonas ou regiões, faça o seguinte:
Os exemplos a seguir mostram como mover uma VM entre zonas.
gcloud
Neste exemplo, você move uma VM chamada
myinstance
que tem dois discos permanentes chamadosmybootdisk
emydatadisk
, deeurope-west1-c
paraus-west1-b
.Ir
Java
Node.js
Pitão
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.
-