Lista de verificação de migração do projeto

Esta lista de verificação vai ajudar você a migrar projetos entre os recursos da 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, instruções breves para cada etapa e um link para mais informações.

Criar um plano de migração

Pense em como sua migração afetará os serviços em execução no projeto. As alterações na hierarquia de recursos causadas pela migração de um projeto podem levar a mudanças nas políticas herdadas, como políticas da organização e do Identity and Access Management.

Crie um plano para garantir que os possíveis impactos sejam atenuados durante a migração do projeto. Para ajudar a informar seu plano, use a API Move Analysis para conferir um detalhamento dos obstáculos à migração do projeto.

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

Atribuir papéis de gerenciamento de identidade e acesso

Você precisa de um conjunto específico de papéis do IAM para migrar um projeto entre os recursos da organização. Você também precisará de permissão para criar e gerenciar políticas da organização.

Para receber essas permissões, adquira os papéis a seguir:

• Transportador de projeto (roles/resourcemanager.projectMover) no projeto que você quer migrar e no recurso pai.

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

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

Para saber mais sobre os papéis e permissões necessários, consulte Atribuir permissões.

Configurar políticas da organização

Para realizar uma migração de projeto entre os recursos da organização, defina as seguintes políticas da organização:

• Defina a restrição constraints/resourcemanager.allowedExportDestinations no recurso pai do projeto que você quer migrar. Essa 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. Essa restrição define os recursos da organização de onde os projetos podem ser importados.

Se uma dessas restrições não estiver configurada corretamente, a migração falhará com um erro FAILED_PRECONDITION.

Para configurar as políticas da organização necessárias para a migração do projeto, você precisa ter o papel roles/orgPolicy.policyAdmin na organização pai e de destino.

Para mais informações sobre essas restrições da política da organização, consulte Configurar políticas da organização.

Atender a casos especiais

Ao migrar um projeto entre recursos da organização, é possível que você precise resolver alguns cenários no nível do projeto e dos recursos da organização. Pode haver serviços envolvidos que você precisa considerar como parte do plano de migração. Considere esses casos se você depender dos serviços envolvidos na operação do projeto.

Para ver uma lista de casos especiais e como lidar com eles, consulte Como processar casos especiais.

Faça a migração

Depois de concluir as etapas acima, você pode usar a API Resource Manager para migrar um projeto. Use o comando gcloud beta projects move da Google Cloud CLI ou o método projects.update() da API REST para realizar a migração.

Para mais detalhes sobre como migrar seu projeto, consulte Executar a migração.