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

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 gerenciamento de identidade e acesso.

Crie um plano para garantir que os possíveis impactos sejam mitigados durante a migração de projetos. 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.

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 projetos (roles/resourcemanager.projectMover) do projeto que você quer a ser migrado e o recurso pai dele.

• 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.

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

• Defina a restrição constraints/resourcemanager.allowedExportDestinations no recurso pai para o 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.

Ao migrar um projeto entre recursos da organização, há uma chance de você precisar abordar certos cenários no projeto e de 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.

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

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