Lista de tareas para la migración de proyectos

Esta lista de tareas te ayudará a migrar proyectos entre los recursos de la organización. La siguiente lista de tareas contiene una lista de las tareas principales involucradas en la migración de un proyecto entre los recursos de la organización, instrucciones breves para cada paso y un vínculo a más información.

Crea un plan de migración

Debes considerar cómo la migración afectará a los servicios que se ejecutan dentro del proyecto. Los cambios en la jerarquía de recursos causados por una migración de proyectos pueden generar cambios en las políticas heredadas, como las políticas de la organización y las de Identity and Access Management.

Crea un plan para asegurarte de que se mitiguen los posibles impactos durante la migración de tu proyecto. Para fundamentar tu plan, usa la API de Move Analysis y obtén un desglose detallado de los bloqueos para la migración del proyecto.

Para obtener más información, consulta Crea un plan de migración.

Asigna roles de Identity and Access Management

Necesitas un conjunto particular de roles de IAM para migrar un proyecto entre los recursos de la organización. También necesitarás permiso para crear y administrar políticas de la organización.

Puedes obtener estos permisos si adquieres los siguientes roles:

• Migrador de proyectos (roles/resourcemanager.projectMover) en el proyecto que deseas migrar y su recurso superior.

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

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

Para obtener más detalles sobre los roles y permisos que necesitas, consulta Cómo asignar permisos.

Configura las políticas de la organización

Para realizar una migración de proyectos entre recursos de la organización, debes configurar las siguientes políticas de la organización:

• Establece la restricción constraints/resourcemanager.allowedExportDestinations en el recurso superior del proyecto que deseas migrar. Esta restricción define los recursos de la organización a los que se puede migrar el proyecto.

• Configura 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 los proyectos.

Si no se configuran correctamente ninguna de estas restricciones, la migración fallará con un error FAILED_PRECONDITION.

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

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

Aborda cualquier caso especial

Cuando migras un proyecto entre recursos de la organización, es posible que debas abordar ciertas situaciones a nivel del proyecto y de los recursos de la organización. Es posible que haya servicios involucrados que debas tener en cuenta. Como parte de tu plan de migración, debes considerar estos casos si dependes de los servicios involucrados para la operación de tu proyecto.

Para obtener una lista de casos especiales y cómo manejarlos, consulta Cómo manejar casos especiales.

Realice la migración

Una vez que hayas terminado los pasos anteriores, puedes usar la API de 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 de REST para realizar la migración.

Para obtener más detalles sobre cómo migrar tu proyecto, consulta Cómo realizar la migración.