Checkliste zur Projektmigration

Diese Checkliste hilft Ihnen dabei, Projekte zwischen den Ressourcen einer Organisation zu migrieren. Die folgende Checkliste enthält eine Liste der wichtigsten Aufgaben beim Migrieren eines Projekts zwischen den Ressourcen einer Organisation, eine kurze Anleitung für jeden Schritt und einen Link zu weiteren Informationen.

Einen Migrationsplan erstellen

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-Richtlinien 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.

IAM-Rollen zuweisen

Sie benötigen einen bestimmten Satz von IAM-Rollen, um ein Projekt zwischen den Ressourcen einer Organisation 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 Ressourcen der Quell- als auch der Zielorganisation.

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

Organisationsrichtlinien konfigurieren

Wenn Sie ein Projekt zwischen Organisationsressourcen migrieren möchten, müssen Sie die folgenden Organisationsrichtlinien festlegen:

• Legen Sie die Einschränkung constraints/resourcemanager.allowedExportDestinations für die übergeordnete Ressource des Projekts fest, das Sie migrieren möchten. Mit dieser Einschränkung werden die Ressourcen der Organisation definiert, in die das Projekt migriert werden kann.

• Legen Sie die Einschränkung constraints/resourcemanager.allowedImportSources für die Zielressource fest. Mit dieser Einschränkung werden die Ressourcen der Organisation 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.

Um die für die Projektmigration erforderlichen Organisationsrichtlinien zu konfigurieren, benötigen Sie die Rolle roles/orgPolicy.policyAdmin in der übergeordneten und der Zielorganisation.

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

Sonderfälle bearbeiten

Wenn Sie ein Projekt zwischen Organisationsressourcen migrieren, müssen Sie möglicherweise bestimmte Szenarien auf Projekt- und Organisationsressourcenebene angehen. Es kann sein, dass Sie bestimmte Dienste 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.

Migration ausführen

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

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