App Engine-Container-Images zu Artifact Registry migrieren

Regions-ID

REGION_ID ist ein abgekürzter Code, den Google anhand der Region zuweist, die Sie beim Erstellen Ihrer Anwendung ausgewählt haben. Der Code bezieht sich nicht auf ein Land oder eine Provinz, auch wenn einige Regions-IDs häufig verwendeten Länder- und Provinzcodes ähneln können. Bei Anwendungen, die nach Februar 2020 erstellt wurden, ist REGION_ID.r in den App Engine-URLs enthalten. Bei Anwendungen, die vor diesem Datum erstellt wurden, ist die Regions-ID in der URL optional.

Hier finden Sie weitere Informationen zu Regions-IDs.

Container Registry wurde eingestellt und am 18. März 2025 deaktiviert. Wir empfehlen, Artifact Registry zum Speichern und Verwalten von Container-Images zu verwenden. Standardmäßig verwenden neue Bereitstellungen, die nach dem 5. März 2025 erstellt werden, Artifact Registry anstelle von Container Registry zum Speichern von Anwendungs-Images. Artifact Registry bietet die gleichen Funktionen zur Containerverwaltung wie Container Registry und umfasst zusätzliche Funktionen und Vorteile. Als vollständig verwalteter Dienst mit Unterstützung sowohl für Container-Images als auch für Nicht-Container-Artefakte erweitert Artifact Registry die Möglichkeiten von Container Registry.

Bei Projekten, die vor Mai 2024 erstellt wurden oder für die das automatisierte Migrationstool noch nicht ausgeführt wurde, folgen Sie der Anleitung in diesem Dokument, um App Engine zu aktivieren, damit Ihre Bereitstellungsabläufe automatisch migriert werden.

App Engine-Standardumgebung

Die meisten Ihrer Anwendungskomponenten in der Standardumgebung folgen einem automatisierten Migrationsprozess. Damit die Umstellung auf Artifact Registry reibungslos verläuft, muss Ihr Dienstkonto jedoch die folgenden erforderlichen Berechtigungen haben:

  • Bei vorhandenen Standardbereitstellungen muss das bereitstellende Dienstkonto (entweder das App Engine-Standarddienstkonto (PROJECT_ID@appspot.gserviceaccount.com) oder Ihr benutzerdefiniertes Dienstkonto) eine Rolle haben, die die explizite Artifact Registry-Schreibberechtigung artifactregistry.repositories.uploadArtifacts gewährt. Informationen zum Ermitteln der Rollen, die Ihrem Dienstkonto für die Bereitstellung zugewiesen sind, finden Sie unter Zugriff auf Dienstkonten verwalten.

  • Für neue Bereitstellungen kann Artifact Registry verwendet werden, wenn eine der folgenden Rollen im Dienstkonto vorhanden ist, das mit Bereitstellungen verknüpft ist:

    Wenn keine dieser Rollen vorhanden ist, weisen Sie Ihrem bereitstellenden Dienstkonto die Rolle „Artifact Registry Writer“ (roles/artifactregistry.writer) zu.

Wenn Sie die erforderlichen Berechtigungen nicht angeben, können Sie keine neuen Versionen in der Standardumgebung bereitstellen.

Bei automatisierten Migrationen kann Google Cloud neue Repositories erstellen und Images aus Container Registry in Artifact Registry kopieren.

Flexible App Engine-Umgebung

Die meisten Ihrer Anwendungskomponenten in der flexiblen Umgebung folgen einem automatisierten Migrationsprozess. Damit die Umstellung auf Artifact Registry reibungslos verläuft, muss Ihr Dienstkonto jedoch die folgenden erforderlichen Berechtigungen haben:

  • Damit vorhandene flexible Bereitstellungen mit Artifact Registry wie erwartet funktionieren, muss das bereitstellende Dienstkonto (entweder das App Engine-Standarddienstkonto (PROJECT_ID@appspot.gserviceaccount.com) oder Ihr benutzerdefiniertes Dienstkonto) eine Rolle haben, die die expliziten Artifact Registry-Berechtigungen wie artifactregistry.repositories.downloadArtifacts für das Lesen und artifactregistry.repositories.uploadArtifacts für das Schreiben gewährt. Informationen zum Ermitteln der Rollen, die Ihrem Dienstkonto für die Bereitstellung zugewiesen sind, finden Sie unter Zugriff auf Dienstkonten verwalten.

  • Für neue Bereitstellungen kann Artifact Registry verwendet werden, wenn eine der folgenden Rollen im Dienstkonto vorhanden ist, das mit Bereitstellungen verknüpft ist:

    Wenn keine dieser Rollen vorhanden ist, weisen Sie Ihrem bereitstellenden Dienstkonto die Rolle „Artifact Registry Repository Administrator“ (roles/artifactregistry.repoAdmin) zu.

Wenn Sie die erforderlichen Berechtigungen nicht angeben, können Sie keine Anwendungen in der flexiblen Umgebung bereitstellen. Auch das Skalieren und Neustarten von Instanzen schlägt fehl.

Bei automatisierten Migrationen kann Google Cloud neue Repositories erstellen und Images aus Container Registry in Artifact Registry kopieren.

Zu Artifact Registry für manuell erstellte Container-Images migrieren

Der automatisierte Migrationsprozess wird nicht angewendet, wenn Sie Ihre Apps zuvor mit vordefinierten oder manuell erstellten Container-Images aus der Container Registry bereitgestellt haben. Der automatisierte Migrationsprozess funktioniert beispielsweise nicht, wenn Sie Container-Images mit Docker erstellt, diese Images in die Container Registry übertragen und Ihre Apps mit dem Befehl gcloud app deploy --image-url bereitgestellt haben.

Wenn Sie vordefinierte oder manuell erstellte Container-Images aus Container Registry zum Bereitstellen Ihrer Apps verwenden, haben Sie folgende Möglichkeiten, zu Artifact Registry zu migrieren:

  • Verwenden Sie das automatische Migrationstool, um von Container Registry zu gcr.io-Repositories zu migrieren, die in Artifact Registry gehostet werden. Wenn Sie dieses Tool verwenden, müssen Sie keine neuen Versionen Ihres Dienstes neu bereitstellen. Weitere Informationen finden Sie unter Automatische Migration von Container Registry zu Artifact Registry.

  • Container-Images manuell von Container Registry zu Artifact Registry migrieren und neue Versionen Ihres Dienstes neu bereitstellen. Weitere Informationen finden Sie unter Manuelle Migration zu gcr.io-Repositories in Artifact Registry.

  • Verwenden Sie das Flag copy-only, um Ihre Container-Images in Artifact Registry zu kopieren und neue Versionen Ihres Dienstes neu bereitzustellen.