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. Alterações na hierarquia de recursos causadas por uma migração de projeto podem resultar às mudanças em políticas herdadas, como políticas da organização e Políticas 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 definir seu plano, use o API Move Analysis para ver um detalhamento dos obstáculos para a 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 destino uma pasta específica ou um recurso da organização.

• Administrador de políticas da organização (roles/orgpolicy.policyAdmin) na origem e os recursos da organização 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:

• 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 o 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, 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 que, como parte de seu plano de migração, você deve considere estes casos se você depende dos serviços envolvidos na operação do seu 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.