Checkliste zur Projektmigration

Sie sollten berücksichtigen, wie sich die Migration auf die im Projekt ausgeführten Dienste auswirkt. Änderungen an der Ressourcenhierarchie, die durch eine Projektmigration verursacht werden, können zu Änderungen an übernommenen Richtlinien wie Organisationsrichtlinien und IAM-Zulassungs- und -Ablehnungsrichtlinien führen.

Erstellen Sie einen Plan, um sicherzustellen, dass die möglichen Auswirkungen während der Projektmigration minimiert werden. In der Move Analysis API finden Sie eine detaillierte Aufschlüsselung der Blockierungen für die Projektmigration.

Weitere Informationen finden Sie unter Migrationsplan erstellen.

Sie benötigen einen bestimmten Satz von IAM-Rollen, um ein Projekt zwischen Ressourcen von Organisationen zu migrieren. Sie benötigen außerdem Berechtigungen zum Erstellen und Verwalten von Organisationsrichtlinien.

Sie können diese Berechtigungen erhalten, indem Sie die folgenden Rollen erwerben:

• Projektverschieber (roles/resourcemanager.projectMover) für das Projekt, das Sie migrieren möchten, und dessen übergeordnete Ressource.

• Projektersteller (roles/resourcemanager.projectCreator) für den Zielordner oder die Zielorganisationsressource.

• Administrator für Organisationsrichtlinien (roles/orgpolicy.policyAdmin) sowohl für die Quell- als auch für die Zielorganisationsressourcen.

Weitere Informationen zu den erforderlichen Rollen und Berechtigungen finden Sie unter Berechtigungen zuweisen.

Wenn Sie eine Projektmigration zwischen Organisationsressourcen durchführen möchten, müssen Sie die folgenden Organisationsrichtlinien festlegen:

• Legen Sie die Einschränkung constraints/resourcemanager.allowedExportDestinations für die übergeordnete Ressource für das Projekt fest, das Sie migrieren möchten. Mit dieser Einschränkung werden die Organisationsressourcen definiert, zu denen das Projekt migriert werden kann.

• Legen Sie die Einschränkung constraints/resourcemanager.allowedImportSources für die Zielressource fest. Mit dieser Einschränkung werden die Organisationsressourcen definiert, aus denen Projekte importiert werden können.

Wenn eine dieser Einschränkungen nicht richtig festgelegt ist, schlägt die Migration mit dem Fehler FAILED_PRECONDITION fehl.

Zum Konfigurieren der für die Projektmigration erforderlichen Organisationsrichtlinien benötigen Sie die Rolle roles/orgPolicy.policyAdmin in der übergeordneten Organisation und der Zielorganisation.

Weitere Informationen zu diesen Einschränkungen für Organisationsrichtlinien finden Sie unter Organisationsrichtlinien konfigurieren.

Wenn Sie ein Projekt zwischen Organisationsressourcen migrieren, müssen Sie möglicherweise bestimmte Szenarien auf Projekt- und Organisationsressourcenebene berücksichtigen. Es können Dienste beteiligt sein, die Sie berücksichtigen müssen. Im Rahmen Ihres Migrationsplans sollten Sie diese Fälle berücksichtigen, wenn der Betrieb Ihres Projekts von den beteiligten Diensten abhängig ist.

Eine Liste der Sonderfälle und deren Behandlung finden Sie unter Sonderfälle behandeln.

Nachdem Sie die oben genannten Schritte ausgeführt haben, können Sie die Resource Manager API zum Migrieren eines Projekts verwenden. Zum Migrieren können Sie den Befehl gcloud beta projects move der Google Cloud CLI oder die REST API-Methode projects.update() verwenden.

Weitere Informationen zur Migration Ihres Projekts finden Sie unter Migration ausführen.