Lista de comprobación para migrar proyectos

Esta lista de comprobación te ayudará a migrar proyectos entre recursos de organización. La lista de comprobación que se muestra a continuación contiene una lista de las tareas principales que implica migrar un proyecto entre recursos de organización, instrucciones breves para cada paso y un enlace a más información.

Crear un plan de migración

Debes tener en cuenta cómo afectará la migración a los servicios que se ejecutan en el proyecto. Los cambios en la jerarquía de recursos provocados por una migración de proyectos pueden provocar cambios en las políticas heredadas, como las políticas de organización y las políticas de gestión de identidades y accesos (IAM) de permiso y denegación.

Crea un plan para asegurarte de que se mitiguen los posibles impactos durante la migración del proyecto. Para ayudarte a planificar la migración, usa la API Move Analysis para obtener un desglose detallado de los bloqueos de la migración del proyecto.

Para obtener más información, consulta el artículo Crear un plan de migración.

Asignar roles de Gestión de Identidades y Accesos

Necesitas un conjunto concreto de roles de gestión de identidades y accesos para migrar un proyecto entre recursos de organización. También necesitará permiso para crear y gestionar políticas de la organización.

Puedes obtener estos permisos adquiriendo los siguientes roles:

• Trasladador de proyectos (roles/resourcemanager.projectMover) en el proyecto que quieras migrar y en su recurso principal.

• Creador de proyectos (roles/resourcemanager.projectCreator) en la carpeta o el recurso de organización de destino.

• Administrador de políticas de organización (roles/orgpolicy.policyAdmin) en los recursos de organización de origen y de destino.

Para obtener más información sobre los roles y permisos que necesitas, consulta el artículo Asignar permisos.

Configurar políticas de organización

Para migrar un proyecto entre recursos de organización, debes definir las siguientes políticas de organización:

• Define la restricción constraints/resourcemanager.allowedExportDestinations en el recurso principal del proyecto al que quieras migrar. Esta restricción define los recursos de la organización a los que se puede migrar el proyecto.

• Define la restricción constraints/resourcemanager.allowedImportSources en el recurso de destino. Esta restricción define los recursos de la organización desde los que se pueden importar proyectos.

Si alguna de estas restricciones no se define correctamente, la migración fallará y se producirá un error FAILED_PRECONDITION.

Para configurar las políticas de la organización necesarias para la migración del proyecto, debe tener el rol roles/orgPolicy.policyAdmin en la organización principal y en la de destino.

Para obtener más información sobre estas restricciones de las políticas de la organización, consulta Configurar políticas de la organización.

Abordar los casos especiales

Cuando migras un proyecto entre recursos de organización, es posible que tengas que abordar determinadas situaciones a nivel de proyecto y de recurso de organización. Puede que haya servicios implicados que debas tener en cuenta. Como parte de tu plan de migración, debes considerar estos casos si dependes de los servicios implicados para el funcionamiento de tu proyecto.

Para ver una lista de casos especiales y cómo gestionarlos, consulta el artículo Gestionar casos especiales.

Realizar la migración

Una vez que hayas completado los pasos anteriores, podrás usar la API Resource Manager para migrar un proyecto. Puedes usar el comando gcloud beta projects move de Google Cloud CLI o el método projects.update() de la API REST para llevar a cabo la migración.

Para obtener más información sobre cómo migrar tu proyecto, consulta Realizar la migración.