This checklist will help you to migrate projects between organization resources. The checklist below contains a list of the major tasks involved in migrating a project between organization resources, brief instructions for each step, and a link to more information.
Create a plan to make sure that any potential impacts are mitigated during your project migration. To help inform your plan, use the Move Analysis API to get a detailed breakdown of blockers for the project migration.
For more information, see Create a migration plan.
You can get these permissions by acquiring the following roles:
Project Mover (
roles/resourcemanager.projectMover
) on the project you want to migrate and its parent resource.Project Creator (
roles/resourcemanager.projectCreator
) on the destination folder or organization resource.Organization Policy Admin (
roles/orgpolicy.policyAdmin
) on both the source and destination organization resources.
For more details about the roles and permissions you need, see Assign permissions.
Set the
constraints/resourcemanager.allowedExportDestinations
constraint on the parent resource to the project that you want to migrate. This constraint defines the organization resources to which the project can be migrated.Set the
constraints/resourcemanager.allowedImportSources
constraint on the destination resource. This constraint defines the organization resources from which projects can be imported.
If either of these constraints are not properly set, the migration will fail
with a FAILED_PRECONDITION
error.
To configure organization policies required for the project migration, you
must have the roles/orgPolicy.policyAdmin
role on the parent and the destination organization.
For more information about these organization policy constraints, see Configure organization policies.
For a list of special cases and how to handle them, see Handling special cases.
gcloud beta projects move
Google Cloud CLI command, or the projects.update()
REST API method to
perform the migration.
For more details about migrating your project, see Perform the migration.