Migration ausführen

Sie können ein Google Cloud -Projekt zwischen Organisationsressourcen migrieren oder ein eigenständiges Projekt (ohne Organisationsressource) in eine Organisationsressource verschieben. Wenn Sie ein Projekt zwischen Organisationen migrieren möchten, benötigen Sie die erforderlichen IAM-Berechtigungen (Identity and Access Management) und müssen die erforderlichen Organisationsrichtlinien sowohl für die Quell- als auch für die Zielorganisationsressourcen konfigurieren. Wenn Sie ein eigenständiges Projekt verschieben möchten, benötigen Sie nur die erforderlichen IAM-Berechtigungen für das Projekt und die Zielorganisationsressource sowie die erforderlichen Organisationsrichtlinien für die Zielorganisationsressource.

Hinweis

Eine Projektmigration ist ein organisationsübergreifender Vorgang. Damit Ressourcen nicht unbefugt verschoben werden können, müssen Sie die folgenden Anforderungen erfüllen.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Migrieren von Projekten zwischen Organisationsressourcen benötigen:

• Projekt-IAM-Administrator (roles/resourcemanager.projectIamAdmin) für das Projekt, das Sie zwischen Organisationsressourcen migrieren möchten
• Project Mover (roles/resourcemanager.projectMover) für die übergeordnete Ressource des Projekts (Ordner- oder Organisationsressource)
• Wenn die Zielressource ein Ordner ist: Project Mover (roles/resourcemanager.projectMover) für die Zielressource
• Wenn die Zielressource eine Organisation ist: Project Creator (roles/resourcemanager.projectCreator) für die Zielressource

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Diese Rollen müssen demselben Nutzerkonto sowohl in der Quell- als auch in der Zielorganisation zugewiesen werden. Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Migrieren von Projekten erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen im Detail anzuzeigen.

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um Projekte zu migrieren:

• resourcemanager.projects.getIamPolicy für das Projekt, das Sie zwischen Organisationsressourcen migrieren möchten
• resourcemanager.projects.update für das Projekt, das Sie zwischen Organisationsressourcen migrieren möchten
• resourcemanager.projects.move für die übergeordnete Ressource des Projekts (Ordner- oder Organisationsressource)
• Wenn die Zielressource ein Ordner ist: resourcemanager.projects.move für die Zielressource
• Wenn die Zielressource eine Organisationsressource ist: resourcemanager.projects.create für die Zielressource
• Wenn Sie ein Projekt migrieren möchten, das keiner Organisation zugeordnet ist: resourcemanager.projects.setIamPolicy für das Projekt, das Sie migrieren möchten

Sie können diese Berechtigungen auch mit einer benutzerdefinierten Rolle oder anderen vordefinierten Rollen erhalten.

Erforderliche Organisationsrichtlinien

Standardmäßig ist die Projektmigration eingeschränkt. Sie müssen den Export und Import explizit zulassen, indem Sie Organisationsrichtlinien auf der Stammebene beider Organisationen festlegen. Zum Konfigurieren der für die Migration erforderlichen Organisationsrichtlinien benötigen Sie die Rolle roles/orgPolicy.policyAdmin für die übergeordnete und die Zielorganisation.

• In der Quellorganisationsressource: Legen Sie die Richtlinie constraints/resourcemanager.allowedExportDestinations fest. Fügen Sie die ID der Zielorganisation als zulässigen Wert hinzu.

• In der Zielorganisationsressource: Legen Sie die Richtlinie constraints/resourcemanager.allowedImportSources fest. Fügen Sie die ID der Quellorganisation als zulässigen Wert hinzu.

Achtung: Wenn diese Richtlinien nicht erzwungen werden, gibt der Migrationsbefehl den Fehler FAILED_PRECONDITION zurück.

Hinweis: Unabhängig davon, ob Sie dedizierte Import- und Exportordner verwenden oder nicht, empfiehlt es sich, diese Organisationsrichtlinien zu entfernen, nachdem Sie Projekte zwischen Organisationsressourcen verschoben haben. Sie können sie wieder erzwingen, wenn Sie eine weitere Projektmigration durchführen müssen.

Migration ausführen

Sobald die Berechtigungen gewährt und die Richtlinien erzwungen wurden, können Sie das Projekt mithilfe der Google Cloud CLI oder der Resource Manager API migrieren.

Hinweis: Die folgende Anleitung gilt nur für die Migration eines Projekts von einer Organisationsressource zu einer anderen Organisationsressource. Wenn das zu migrierende Projekt nicht mit einer Organisationsressource verknüpft ist, lesen Sie den Abschnitt Projekte ohne Organisationsressource migrieren.

gcloud

Führen Sie den folgenden Befehl aus, um ein Projekt zu einer anderen Organisationsressource zu migrieren:

gcloud beta projects move PROJECT_ID \
    --organization ORGANIZATION_ID

Mit dem folgenden Befehl können Sie auch einen Ordner als Zielressource angeben:

gcloud beta projects move PROJECT_ID \
    --folder FOLDER_ID

Ersetzen Sie die folgenden Felder:

• PROJECT_ID: die ID oder Nummer des Projekts, das Sie migrieren möchten.
• ORGANIZATION_ID: die ID der Organisationsressource, in die Sie das Projekt verschieben.
• FOLDER_ID: die ID des Ordners, in den Sie das Projekt verschieben.

Sie können nur ein Ziel angeben, entweder einen Ordner oder eine Organisationsressource.

Hinweis: Sie können diesen Befehl unabhängig vom Bereich Ihrer Google Cloud CLI ausführen.

API

Mit der v1 Resource Manager API können Sie ein Projekt zwischen Organisationsressourcen migrieren, indem Sie das Feld parent auf die ID der Zielressource festlegen.

So migrieren Sie ein Projekt:

• Rufen Sie das project-Objekt mit der Methode projects.get() ab.
• Aktualisieren Sie das Feld parent auf die Zielressourcen-ID.
• Führen Sie die Methode projects.update() aus.

Das folgende Code-Snippet veranschaulicht diese Schritte:

    project = crm.projects().get(projectId=flags.projectId).execute()
    project['parent'] = {
        'type': 'organization',
        'id': flags.organizationId
    }

    project = crm.projects().update(
    projectId=flags.projectId, body=project).execute()

Hinweis: Die Projektmigration dauert in der Regel weniger als eine Minute. Nach der Migration eines Projekts zwischen Organisationsressourcen kann es einige Minuten dauern, bis diese Änderung in der Google Cloud Console angezeigt wird. Informationen zum Abrufen der aktuellen Details eines Projekts finden Sie unter Vorhandenes Projekt abrufen.

Aufgaben nach der Migration

Nach der erfolgreichen Migration Ihres Projekts müssen Sie mehrere Aufgaben nach der Migration ausführen, um die Kontinuität des Betriebs, die Einhaltung von Sicherheitsrichtlinien und die korrekte Abrechnung zu gewährleisten. Durch die Migration eines Projekts ändert sich seine Ressourcenhierarchie, was sich auf übernommene Berechtigungen und Richtlinien auf Organisationsebene auswirkt.

Hier sind einige Schritte, die Sie nach der Migration ausführen können:

1. Richtlinienprüfung: Prüfen Sie, ob das Projekt die erwarteten Organisationsrichtlinien von der neuen übergeordneten Ressource übernimmt.

2. Zugriffssteuerung: Prüfen Sie die IAM-Rollen, um sicherzustellen, dass Nutzer in der neuen Organisation den erforderlichen Zugriff haben.

3. Abrechnung: Aktualisieren Sie das Rechnungskonto, wenn das Projekt der Zielorganisation in Rechnung gestellt werden soll. Dieser Schritt ist optional. Weitere Informationen finden Sie unter Rechnungskonto für ein Projekt ändern und Rechnungskonto zwischen Organisationsressourcen migrieren.

4. Bereinigung: Widerrufen Sie die temporären Rollen „Project Mover“ und entfernen Sie die Einschränkungen allowedExportDestinations und allowedImportSources.“

Rechnungskonto für ein Projekt ändern

Cloud-Rechnungskonten können organisationsressourcenübergreifend verwendet werden. Das Verschieben eines Projekts von einer Organisationsressource zu einer anderen hat keine Auswirkungen auf die Abrechnung. Die Kosten werden weiterhin über das alte Rechnungskonto abgerechnet. Bei der Migration von Projekten zwischen Organisationsressourcen ist jedoch häufig auch eine Migration zu einem neuen Rechnungskonto erforderlich.

So ändern Sie das Rechnungskonto:

1. Rufen Sie in der Google Cloud Console die Seite Abrechnung auf.
   Zur Seite "Abrechnung"
2. Klicken Sie auf den Namen des Rechnungskontos, das Sie ändern möchten.
3. Suchen Sie unter Mit diesem Rechnungskonto verknüpfte Projekte nach dem Namen des Projekts, das Sie migrieren möchten, und klicken Sie dann rechts auf die Menüschaltfläche.
4. Klicken Sie auf Abrechnung ändern und wählen Sie das neue Rechnungskonto aus.
5. Klicken Sie auf Konto festlegen.

Bereits angefallene Gebühren, die noch nicht im Transaktionsverlauf aufgeführt sind, werden dem vorherigen Rechnungskonto belastet. Dies kann Gebühren von bis zu zwei Tagen vor der Migration des Projekts umfassen.

Hinweis: Wenn Sie das Rechnungskonto ändern, das mit einem Projekt verbunden ist, das aktive Google Cloud Marketplace-Abos hat, werden diese Abos automatisch gekündigt. Weitere Informationen finden Sie unter Abrechnung für Cloud Marketplace-Produkte verwalten.

Rechnungskonto zwischen Organisationsressourcen migrieren

Ein Rechnungskonto kann von einer Organisationsressource zu einer anderen migriert werden, obwohl dies nicht oft erforderlich ist. Die meisten vorhandenen Organisationsressourcen haben bereits ein Rechnungskonto, das stattdessen verwendet werden sollte.

Wenn einem neuen Rechnungskonto keine Organisationsressource zugeordnet ist, müssen Sie die Rolle roles/billing.admin für das Rechnungskonto und die Rollen roles/billing.admin und roles/billing.creator für die Organisationsressource erhalten, die Sie mit Ihrem Rechnungskonto verknüpfen möchten.

Wenn Sie ein vorhandenes Rechnungskonto migrieren müssen:

1. Rufen Sie in der Google Cloud Console die Seite Abrechnung auf.
   Zur Seite "Abrechnung"
2. Klicken Sie auf den Namen des Rechnungskontos, das Sie migrieren möchten.
3. Klicken Sie oben auf der Seite Kontoverwaltung auf Organisation ändern.
4. Wählen Sie die Zielorganisationsressource aus und klicken Sie auf OK.

Das Rechnungskonto ist jetzt mit der angegebenen Organisationsressource verknüpft.

Migration rückgängig machen

Google Cloud -Migrationen zwischen Organisationen werden nicht automatisch rückgängig gemacht, wenn während oder nach der Migration ein Problem auftritt. Wenn Sie eine Migration rückgängig machen müssen, müssen Sie manuell einen Rollback ausführen.

Wenn Sie ein Projekt versehentlich migriert haben, können Sie den Vorgang rückgängig machen. Führen Sie dazu die Migration noch einmal aus, wobei die alte Quelle das neue Ziel und das alte Ziel die neue Quelle ist. Sie müssen die erforderlichen IAM-Berechtigungen haben und die Organisationsrichtlinien müssen erzwungen werden, damit dies wie eine völlig neue Migration möglich ist.

So machen Sie eine Migration rückgängig:

1. Tauschen Sie die Quell- und Ziel-IDs in Ihren Organisationsrichtlinien (allowedExportDestinations und allowedImportSources).
2. Wiederholen Sie den Migrationsbefehl und verschieben Sie das Projekt zurück zur ursprünglichen Quell-ID.

Hinweis: Wenn Sie eine Migration für ein Projekt rückgängig machen möchten, das ursprünglich „Keine Organisation“ hatte, wenden Sie sich an den Google Cloud Customer Care.

Nächste Schritte

• Sonderfälle bearbeiten