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.

Weitere Informationen zu Regions-IDs.

Container Registry ist veraltet und wurde am 18. März 2025 eingestellt. Wir empfehlen, Artifact Registry zum Speichern und Verwalten von Container-Images zu verwenden. Standardmäßig werden bei neuen Bereitstellungen, die nach dem 5. März 2025 erstellt wurden, Anwendungs-Images in Artifact Registry statt in Container Registry gespeichert. 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 Tool für die automatisierte Migration noch nicht ausgeführt wurde, folgen Sie der Anleitung in diesem Leitfaden, um App Engine so zu konfigurieren, dass Ihre Bereitstellungsabläufe automatisch migriert werden.

App Engine-Standardumgebung

Die meisten Anwendungskomponenten in der Standardumgebung werden automatisch migriert. Für einen reibungslosen Übergang zu Artifact Registry 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 zu den Rollen, die Ihrem bereitstellenden Dienstkonto zugewiesen sind, finden Sie unter Zugriff auf Dienstkonten verwalten.

  • Bei neuen Bereitstellungen kann Artifact Registry verwendet werden, wenn eine der folgenden Rollen im Dienstkonto vorhanden ist, das mit den Bereitstellungen verknüpft ist:

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

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

Bei automatisierten Migrationen Google Cloud können neue Repositories erstellt und Images aus Container Registry in Artifact Registry kopiert werden.

Flexible App Engine-Umgebung

Die meisten Anwendungskomponenten in der flexiblen Umgebung werden automatisch migriert. Für einen reibungslosen Übergang zu Artifact Registry muss Ihr Dienstkonto jedoch die folgenden erforderlichen Berechtigungen haben:

  • Damit vorhandene flexible Bereitstellungen wie erwartet mit Artifact Registry 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 gewährt, z. B. artifactregistry.repositories.downloadArtifacts für den Lesezugriff und artifactregistry.repositories.uploadArtifacts für den Schreibzugriff. Informationen zu den Rollen, die Ihrem bereitstellenden Dienstkonto zugewiesen sind, finden Sie unter Zugriff auf Dienstkonten verwalten.

  • Bei neuen Bereitstellungen kann Artifact Registry verwendet werden, wenn eine der folgenden Rollen im Dienstkonto vorhanden ist, das mit den Bereitstellungen verknüpft ist:

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

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

Bei automatisierten Migrationen Google Cloud können neue Repositories erstellt und Images aus Container Registry in Artifact Registry kopiert werden.

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

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

Wenn Sie vordefinierte oder manuell erstellte Container-Images aus Container Registry verwenden, um Ihre Anwendungen bereitzustellen, wählen Sie eine der folgenden Optionen aus, um zu Artifact Registry zu migrieren:

  • Verwenden Sie das Tool für die automatische Migration, 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.

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

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