Lista de verificação da migração de projetos

Esta lista de verificação ajuda a migrar projetos entre recursos de organização. A lista de verificação abaixo contém uma lista das principais tarefas envolvidas na migração de um projeto entre recursos da organização, breves instruções para cada passo e um link para mais informações.

Crie um plano de migração

Deve considerar o impacto da migração nos serviços em execução no projeto. As alterações na hierarquia de recursos causadas por uma migração de projetos podem levar a alterações nas políticas herdadas, como as políticas da organização e as políticas de permissão e negação da gestão de identidade e de acesso (IAM).

Crie um plano para garantir que os potenciais impactos são mitigados durante a migração do projeto. Para ajudar a fundamentar o seu plano, use a API Move Analysis para obter uma discriminação detalhada dos bloqueadores para a migração do projeto.

Para mais informações, consulte o artigo Crie um plano de migração.

Atribua funções de gestão de identidade e acesso

Precisa de um conjunto específico de funções do IAM para migrar um projeto entre recursos da organização. Também precisa de autorização para criar e gerir políticas da organização.

Pode obter estas autorizações adquirindo as seguintes funções:

• Project Mover (roles/resourcemanager.projectMover) no projeto que quer migrar e no respetivo recurso principal.

• Criador do projeto (roles/resourcemanager.projectCreator) no recurso de pasta ou organização de destino.

• Administrador da política da organização (roles/orgpolicy.policyAdmin) nos recursos da organização de origem e de destino.

Para ver mais detalhes sobre as funções e as autorizações de que precisa, consulte o artigo Atribua autorizações.

Configure políticas da organização

Para fazer uma migração de projetos entre recursos da organização, tem de definir as seguintes políticas da organização:

• Defina a restrição constraints/resourcemanager.allowedExportDestinations no recurso principal para o projeto que quer migrar. Esta restrição define os recursos da organização para os quais o projeto pode ser migrado.

• Defina a restrição constraints/resourcemanager.allowedImportSources no recurso de destino. Esta restrição define os recursos da organização a partir dos quais os projetos podem ser importados.

Se alguma destas restrições não estiver definida corretamente, a migração falha com um erro FAILED_PRECONDITION.

Para configurar as políticas da organização necessárias para a migração do projeto, tem de ter a função roles/orgPolicy.policyAdmin na organização principal e de destino.

Para mais informações sobre estas restrições da política da organização, consulte o artigo Configure políticas da organização.

Aborde casos especiais

Quando migra um projeto entre recursos da organização, existe a possibilidade de ter de resolver determinados cenários ao nível do projeto e do recurso da organização. Podem estar envolvidos serviços que tem de considerar. Como parte do seu plano de migração, deve considerar estes casos se depender dos serviços envolvidos para o funcionamento do seu projeto.

Para ver uma lista de casos especiais e como os processar, consulte o artigo Processamento de casos especiais.

Faça a migração

Depois de concluir os passos acima, pode usar a API Resource Manager para migrar um projeto. Pode usar o comando da gcloud beta projects moveCLI do Google Cloud ou o método da API REST projects.update() para fazer a migração.

Para mais detalhes sobre a migração do seu projeto, consulte a secção Realize a migração.