Checklist pour la migration de projets

Cette checklist vous aidera à migrer des projets entre les ressources de votre organisation. La checklist ci-dessous contient une liste des principales tâches impliquées dans la migration d'un projet entre les ressources de l'organisation, de brèves instructions pour chaque étape et un lien vers plus d'informations.

Vous devez réfléchir à l'impact de votre migration sur les services exécutés dans le projet. Les changements dans la hiérarchie des ressources causés par une migration de projet peuvent entraîner des modifications dans les stratégies héritées, telles que les règles d'administration et les stratégies IAM.

Créez un plan pour vous assurer de remédier à toutes les conséquences potentielles de la migration de votre projet. Pour vous aider à élaborer votre plan, utilisez l'API Move Analysis pour obtenir une répartition détaillée des blocages pour la migration du projet.

Pour en savoir plus, consultez la section Créer un plan de migration.

Vous devez disposer d'un ensemble particulier de rôles IAM pour migrer un projet entre les ressources de l'organisation. Vous aurez également besoin d'une autorisation pour créer et gérer des règles d'administration.

Vous pouvez obtenir ces autorisations en acquérant les rôles suivants :

  • Déplaceur de projets (roles/resourcemanager.projectMover) sur le projet que vous souhaitez migrer et sa ressource parente.

  • Créateur de projet (roles/resourcemanager.projectCreator) sur le dossier ou la ressource d'organisation de destination.

  • Administrateur des règles d'administration (roles/orgpolicy.policyAdmin) sur les ressources des organisations source et de destination.

Pour en savoir plus sur les rôles et les autorisations dont vous avez besoin, consultez la section Attribuer des autorisations.

Pour migrer un projet entre les ressources d'une organisation, vous devez définir les règles d'administration d'administration suivantes:

  • Définissez la contrainte constraints/resourcemanager.allowedExportDestinations sur la ressource parente du projet que vous souhaitez migrer. Cette contrainte définit les ressources de l'organisation vers lesquelles le projet peut être migré.

  • Définissez la contrainte constraints/resourcemanager.allowedImportSources sur la ressource de destination. Cette contrainte définit les ressources de l'organisation à partir desquelles des projets peuvent être importés.

Si l'une de ces contraintes n'est pas correctement définie, la migration échouera avec une erreur FAILED_PRECONDITION.

Pour configurer les règles d'administration requises pour la migration de projet, vous devez disposer du rôle roles/orgPolicy.policyAdmin dans l'organisation parente et dans l'organisation de destination.

Pour en savoir plus sur ces contraintes de règles d'administration, consultez la section Configurer les règles d'administration.

Lorsque vous migrez un projet entre des ressources d'organisation, vous devrez peut-être traiter certains scénarios au niveau du projet et des ressources de l'organisation. Dans le cadre de votre plan de migration, vous devez prendre en compte ces cas si vous dépendez des services impliqués pour le bon fonctionnement de votre projet.

Pour obtenir la liste des cas particuliers et découvrir comment les gérer, consultez la section Gérer les cas particuliers.

Une fois que vous avez terminé les étapes ci-dessus, vous pouvez utiliser l'API Resource Manager pour migrer un projet. Vous pouvez utiliser la commande Google Cloud CLI gcloud beta projects move ou la méthode d'API REST projects.update() pour effectuer la migration.

Pour en savoir plus sur la migration de votre projet, consultez la page Effectuer la migration.