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 mudanças na hierarquia de recursos causadas pela migração de um projeto podem levar a alterações nas políticas herdadas, como políticas da organização e de permissão e negação do Identity and Access Management (IAM).

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 ver um detalhamento dos obstáculos à 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 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 o recurso pai.

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

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

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

Para migrar um projeto entre recursos de 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 mãe 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, talvez seja necessário resolver determinados cenários no nível do projeto e do recurso da organização. Pode haver serviços envolvidos que você precisa considerar como parte do plano de migração. Considere esses casos se 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. Use o comando da Google Cloud CLI gcloud beta projects move ou o método da API REST projects.update() para fazer a migração.

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