App Engine-Anwendung in der Standardumgebung in Cloud Run bereitstellen

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.

In diesem Leitfaden wird beschrieben, wie Sie Ihre vorhandenen Anwendungen in der Standardumgebung in Cloud Run bereitstellen. Die Anleitung gilt für Laufzeiten der zweiten Generation, die die gebündelten Legacy-Dienste von App Engine nicht verwenden.

Die in diesem Leitfaden beschriebenen Schritte haben keine Auswirkungen auf die Funktionalität oder den Trafficfluss Ihrer vorhandenen App Engine-Anwendung. Der neu erstellte Cloud Run-Dienst ist ein Replikat des App Engine-Dienstes, das Sie unabhängig testen können.

Cloud Run verwendet einen Großteil derselben Infrastruktur wie die App Engine-Standardumgebung, was zu vielen Ähnlichkeiten zwischen den Plattformen führt. Weitere Informationen zu den Gemeinsamkeiten und Unterschieden zwischen App Engine und Cloud Run, einschließlich der Vorteile für die Migration zu Cloud Run, finden Sie in der vergleichenden Zusammenfassung.

Wählen Sie eine der folgenden Strategien für die Bereitstellung in Cloud Run aus:

  • Lokale Konfiguration einer app.yaml-Datei verwenden (empfohlen): Wählen Sie diese Option aus, um ein Container-Image direkt aus Ihrem lokalen Quellcode zu erstellen und in Cloud Run bereitzustellen. So wird sichergestellt, dass alle kürzlich vorgenommenen lokalen Änderungen an Ihrem Code oder Ihrer Konfiguration in der neuen Bereitstellung enthalten sind.

  • Zuvor erstelltes Image verwenden: Diese Option ist nützlich, wenn Sie keinen Zugriff auf den Quellcode haben. Wählen Sie diese Option aus, um eine exakte Kopie einer Version bereitzustellen, die bereits in App Engine ausgeführt wird, ohne das Container-Image neu zu erstellen, oder um das Verhalten der aktiven Bereitstellung ohne Codeänderungen zu prüfen.

Hinweis

  1. Achten Sie darauf, dass Ihre App Engine-Anwendung fehlerfrei ausgeführt wird. Sie benötigen Zugriff auf Ihren App Engine-Quellcode, wenn Sie die Bereitstellung mit Ihrer lokalen Konfiguration durchführen möchten.

  2. Aktivieren Sie die Cloud Run Admin API und die Artifact Registry API:

    APIs aktivieren

  3. Konfigurieren Sie Ihr Projekt und Ihre Region mit dem folgenden Befehl:

    gcloud auth login
    gcloud config set project PROJECT_ID
    gcloud config set run/region REGION
    gcloud components update
    

    Ersetzen Sie Folgendes:

    • PROJECT_ID: Projekt-ID in Google Cloud .
    • REGION: die Region, in der Sie Ihren Cloud Run-Dienst bereitstellen möchten.
  4. Prüfen Sie, ob in Ihrer Anwendung inkompatible Funktionen vorhanden sind, und entfernen Sie diese, bevor Sie zu Cloud Run migrieren. Wenn Sie Ihre Anwendung auf Inkompatibilität prüfen möchten, ohne eine Migration oder Bereitstellung durchzuführen, führen Sie den folgenden Befehl in dem Verzeichnis aus, in dem sich die Datei app.yaml befindet:

    gcloud beta app migrate-to-run --dry-run
    

    Prüfen Sie die Ergebnisse der Kompatibilitätsprüfung und nehmen Sie bei Bedarf die empfohlenen Änderungen vor.

  5. Sehen Sie sich die folgenden Cloud Run-Unterschiede an:

    • Cloud Run verwendet den Begriff Revision anstelle von Version, um jedes Mal darzustellen, wenn Sie Änderungen an einem bestimmten Dienst bereitstellen. Wenn Sie Ihre App zum ersten Mal in einem Cloud Run-Dienst bereitstellen, wird die erste Überarbeitung erstellt. Bei jeder nachfolgenden Bereitstellung eines Dienstes wird eine weitere Version erstellt. Weitere Informationen zur Bereitstellung in Cloud Run

    • Sie können Ihren Quellcode in Cloud Run bereitstellen und dieGoogle Cloud Console oder die Google Cloud CLI verwenden, um Ihre Anwendungseinstellungen zu konfigurieren und zu verwalten. Cloud Run erfordert keine dateibasierte Konfiguration. Die YAML-Konfiguration wird jedoch unterstützt.

    • Jeder Dienst, den Sie in Cloud Run bereitstellen, verwendet die Domain run.app in der URL, um öffentlich auf den Dienst zuzugreifen.

    • Im Gegensatz zu standardmäßig öffentlichen App Engine-Diensten sind Cloud Run-Dienste standardmäßig privat. Bei diesen Diensten müssen Sie sie für den öffentlichen (nicht authentifizierten) Zugriff konfigurieren.

Erforderliche Rollen

Sie können entweder ein neues Dienstkonto erstellen oder dasselbe nutzerverwaltete Dienstkonto in Cloud Run verwenden, das Sie für die Standardumgebung verwenden. Sie oder Ihr Administrator müssen dem Deployer-Konto und dem Cloud Build-Dienstkonto die folgenden IAM-Rollen zuweisen.

Klicken, um die erforderlichen Rollen für das Deployer-Konto aufzurufen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen und Bereitstellen aus der Quelle benötigen:

Klicken, um die erforderlichen Rollen für das Cloud Build-Dienstkonto aufzurufen

Cloud Build verwendet automatisch das Compute Engine-Standarddienstkonto als Cloud Build-Standarddienstkonto, um Ihren Quellcode und Ihre Cloud Run-Ressource zu erstellen, sofern Sie dieses Verhalten nicht überschreiben. Damit Cloud Build Ihre Quellen erstellen kann, bitten Sie Ihren Administrator, dem Compute Engine-Standarddienstkonto in Ihrem Projekt die Rolle Cloud Run Builder (roles/run.builder) zuzuweisen:

  gcloud projects add-iam-policy-binding PROJECT_ID \
      --member=serviceAccount:PROJECT_NUMBER-compute@developer.gserviceaccount.com \
      --role=roles/run.builder
  

Ersetzen Sie PROJECT_NUMBER durch Ihre Google Cloud-Projektnummer und PROJECT_ID durch Ihre Google Cloud-Projekt-ID. Eine detaillierte Anleitung zum Ermitteln der Projekt-ID und der Projektnummer finden Sie unter Projekte erstellen und verwalten.

Es dauert einige Minuten, bis die Zuweisung der Rolle „Cloud Run-Builder“ für das Compute Engine-Standarddienstkonto übertragen wurde.

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um ein zuvor erstelltes Image bereitzustellen:

  • App Engine-Bereitsteller (roles/appengine.deployer) für Ihr Projekt. Diese Rolle enthält die Berechtigung appengine.versions.exportAppImage, die Sie zum Exportieren des Container-Images Ihrer App Engine-Version benötigen.
  • Cloud Run-Entwickler (roles/run.developer) für Ihr Projekt.
  • Artifact Registry-Leser (roles/artifactregistry.reader) für Ihr Projekt.
  • Dienstkontonutzer (roles/iam.serviceAccountUser) für die Cloud Run-Dienstidentität.

Optional: Wenn Sie die geschätzten Kosteneinsparungen im Migrations-Hub aufrufen möchten, benötigen Sie die Berechtigung recommender.appengineVersionCostRecommendations.list. Die Rolle „App Engine-Bereitsteller“ und die Rolle App Engine-Betrachter (roles/appengine.appViewer) enthalten diese Berechtigung.

Eine Liste der IAM-Rollen und -Berechtigungen im Zusammenhang mit Cloud Run finden Sie unter IAM-Rollen für Cloud Run und IAM-Berechtigungen für Cloud Run. Wenn Ihr Cloud Run-Dienst mitGoogle Cloud -APIs wie Cloud-Clientbibliotheken verknüpft ist, lesen Sie die Konfigurationsanleitung für Dienstidentitäten. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Bereitstellungsberechtigungen und Zugriff verwalten.

Lokale Konfiguration einer app.yaml-Datei verwenden

Stellen Sie Ihre lokale App Engine-Konfiguration mit der Google Cloud Console oder der Google Cloud CLI in Cloud Run bereit.

Console

  1. Rufen Sie in der Google Cloud Console die Seite App Engine auf.

    Zu App Engine

  2. Klicken Sie im Navigationsmenü auf Migrations-Hub, um Ihre App Engine-Anwendung in Cloud Run bereitzustellen. Im Migrations-Hub können Sie auch Ihre geschätzten Einsparungen bei Cloud Run für Kostenempfehlungen prüfen.

  3. Wählen Sie auf der Karte Migration von Standard zu Cloud Run den Dienst aus, den Sie migrieren möchten, und klicken Sie dann auf Kompatibilität prüfen.

  4. Bestätigen oder wählen Sie im Bereich Kompatibilität prüfen Ihre Version aus, um die Kompatibilitätsergebnisse aufzurufen. Der Migrations-Hub führt einen Kompatibilitätscheck durch, um inkompatible Funktionen zu identifizieren.

  5. Prüfen Sie die Ergebnisse, um sicherzustellen, dass Ihre Anwendung keine blockierenden Inkompatibilitäten aufweist. Klicken Sie dann auf Weiter, um mit dem Abschnitt Prüfen und bereitstellen fortzufahren.

  6. Kopieren Sie auf dem Tab Quellbasierte Bereitstellung den Befehl im Abschnitt Über Gcloud bereitstellen, ersetzen Sie den Platzhalter PATH_TO_APP_YAML durch den Pfad zu Ihrer app.yaml-Datei und führen Sie den Befehl im Quellverzeichnis Ihrer Anwendung aus.

  7. Klicken Sie auf Bereitgestellte Versionen ansehen, um Ihre in Cloud Run bereitgestellten App Engine-Dienste aufzurufen.

gcloud

So stellen Sie Ihren Cloud Run-Dienst mit der lokalen app.yaml-Datei einer vorhandenen App Engine-Konfiguration bereit:

  1. Wechseln Sie in Ihrem Terminal in das Quellverzeichnis, in dem sich die Datei app.yaml befindet.

  2. Führen Sie den folgenden Befehl aus, um Ihren Dienst in Cloud Run bereitzustellen:

    gcloud beta app migrate-to-run
    

    Mit diesem Befehl wird die service.yaml-Dateikonfiguration für Cloud Run generiert und lokal im selben Verzeichnis wie die app.yaml-Datei gespeichert. Weitere Informationen finden Sie unter gcloud beta app migrate-to-run.

    • Geben Sie bei der Aufforderung Proceed with the deployment? den Wert Y ein, um ein Container-Image aus Ihrem Quellcode zu erstellen und den Dienst in Cloud Run bereitzustellen.
  3. Bereitgestellten Cloud Run-Dienst testen Da Ihr Cloud Run-Dienst standardmäßig privat ist, wird beim direkten Öffnen der Dienst-URL in einem Webbrowser der Fehler 403 Forbidden zurückgegeben. Führen Sie einen der folgenden Schritte aus, um Ihren Dienst aufzurufen:

    Optional:

    • Wenn sich die Datei app.yaml in einem anderen Verzeichnis befindet, geben Sie den Pfad mit dem Flag --appyaml an:

      gcloud beta app migrate-to-run --appyaml=PATH
      

      Ersetzen Sie PATH durch den Pfad zur Datei app.yaml.

    • Wenn Sie die Cloud Run-Konfiguration service.yaml generieren und exportieren möchten, ohne den Dienst bereitzustellen, verwenden Sie das Flag --export-only:

      gcloud beta app migrate-to-run --export-only=EXPORT_PATH
      

      Ersetzen Sie EXPORT_PATH durch das Verzeichnis oder den Pfad, in dem Sie die Datei service.yaml speichern möchten.

Zuvor erstelltes Image verwenden

Stellen Sie ein zuvor erstelltes Container-Image aus einer bereitgestellten App Engine-Version in Cloud Run bereit. Verwenden Sie dazu die Google Cloud Console oder die Google Cloud CLI. Das Container-Image wird nicht aus einer lokalen app.yaml-Datei neu erstellt und Sie benötigen den Quellcode Ihrer Anwendung nicht.

Console

  1. Rufen Sie in der Google Cloud Console die Seite App Engine auf.

    Zu App Engine

  2. Klicken Sie im Navigationsmenü auf Migrations-Hub.

  3. Wählen Sie auf der Karte Migration von Standard zu Cloud Run den Dienst aus, den Sie migrieren möchten, und klicken Sie dann auf Kompatibilität prüfen.

  4. Bestätigen oder wählen Sie im Bereich Kompatibilität prüfen die Version aus, die Sie bereitstellen möchten. Der Migrations-Hub führt einen Kompatibilitätscheck durch, um inkompatible Funktionen zu identifizieren.

  5. Prüfen Sie die Ergebnisse, um sicherzustellen, dass Ihre Anwendung keine blockierenden Inkompatibilitäten aufweist. Klicken Sie dann auf Weiter, um mit dem Abschnitt Prüfen und bereitstellen fortzufahren.

  6. Klicken Sie auf den Tab Image-basierte Bereitstellung.

  7. Prüfen Sie die Cloud Run-Einstellungen, die der Migrations-Hub von Ihrer App Engine-Version ableitet, z. B. CPU, Arbeitsspeicher, Skalierung, Nebenläufigkeit, Dienstkonto und Umgebungsvariablen. Sie können diese Einstellungen nach der Bereitstellung ändern. Wenn Sie eine andere Version bereitstellen möchten, klicken Sie auf Version ändern.

  8. Wenn Sie die erforderlichen APIs nicht aktiviert haben, klicken Sie auf Cloud Run APIs aktivieren und dann auf Alle aktivieren, um die Cloud Run Admin API und die Cloud Build API zu aktivieren.

  9. Klicken Sie auf Berechtigungen abgleichen und dann auf Alle gewähren, um Ihrem Nutzerkonto die folgenden IAM-Rollen zuzuweisen:

    • Cloud Run-Entwickler (roles/run.developer)
    • Dienstkontonutzer (roles/iam.serviceAccountUser)
    • Artifact Registry-Leser (roles/artifactregistry.reader)

    Wenn Sie nicht berechtigt sind, APIs zu aktivieren oder Rollen zuzuweisen, bitten Sie Ihren Administrator, die APIs zu aktivieren und die Rollen zuzuweisen.

  10. Klicken Sie auf Bereitstellen. Der Migrations-Hub exportiert das Container-Image Ihrer App Engine-Version und stellt es in einem Cloud Run-Dienst bereit, der denselben Namen wie Ihr App Engine-Dienst hat. Der Dienst wird in der Cloud Run-Region erstellt, die der Region Ihrer App Engine-Anwendung entspricht.

    Wenn in dieser Region bereits ein Cloud Run-Dienst mit demselben Namen vorhanden ist, klicken Sie im Bestätigungsdialogfeld auf Überschreiben und bereitstellen. Bei der Bereitstellung wird eine neue Version erstellt, die 100 % des Traffics verarbeitet und die vorhandenen Authentifizierungs- und Einstellungen für eingehenden Traffic des Dienstes beibehält.

    Nach Abschluss der Bereitstellung wird die Cloud Run-Seite Dienste geöffnet. Sie ist so gefiltert, dass die von App Engine migrierten Dienste angezeigt werden.

  11. Bereitgestellten Cloud Run-Dienst testen Da Ihr Cloud Run-Dienst standardmäßig privat ist, wird beim direkten Öffnen der Dienst-URL in einem Webbrowser der Fehler 403 Forbidden zurückgegeben. Führen Sie einen der folgenden Schritte aus, um Ihren Dienst aufzurufen:

gcloud

  1. Führen Sie den folgenden Befehl aus, um Ihren Dienst in Cloud Run bereitzustellen. Dieser Befehl verwendet das Container-Image einer aktiven App Engine-Bereitstellung und erfasst keine aktuellen Änderungen aus Ihrer lokalen app.yaml-Datei. Dies kann zu einer veralteten Bereitstellung führen:

    gcloud beta app migrate-to-run --service=SERVICE --version=VERSION --from-image
    

    Ersetzen Sie Folgendes:

    • SERVICE: der Name Ihres App Engine-Dienstes.
    • VERSION: Die Versions-ID Ihres Dienstes.

    Mit diesem Befehl wird die Konfiguration des angegebenen Dienstes und der angegebenen Version abgerufen, um die Datei service.yaml für Cloud Run zu generieren. Weitere Informationen finden Sie unter: gcloud beta app migrate-to-run

    • Wenn Sie zur Eingabe von Proceed with the deployment? aufgefordert werden, geben Sie Y ein, um Ihr vorhandenes App Engine-Container-Image zu exportieren und den Dienst in Cloud Run bereitzustellen.
  2. Bereitgestellten Cloud Run-Dienst testen Da Ihr Cloud Run-Dienst standardmäßig privat ist, wird beim direkten Öffnen der Dienst-URL in einem Webbrowser der Fehler 403 Forbidden zurückgegeben. Führen Sie einen der folgenden Schritte aus, um Ihren Dienst aufzurufen:

    Optional:

    • Führen Sie den folgenden Befehl aus, um die Cloud Run-Konfiguration service.yaml zu generieren, ohne den Dienst bereitzustellen:

      gcloud beta app migrate-to-run --service=SERVICE \
          --version=VERSION \
          --from-image \
          --export-only=EXPORT_PATH
      

      Ersetzen Sie EXPORT_PATH durch das Verzeichnis oder den Pfad, in dem Sie die Datei service.yaml speichern möchten.

Inkompatible Features

Der Migrationsbefehl schlägt fehl oder zeigt eine Warnung an, wenn Ihre app.yaml-Datei eine der folgenden nicht unterstützten Konfigurationen enthält:

  • Inbound-Dienste:

    inbound_services:
    - warmup
    

    Lösung: Löschen Sie den Abschnitt inbound_services aus der Datei app.yaml. Cloud Run wärmt Instanzen über den Container-Einstiegspunkt auf, sodass Sie keine Aufwärmanfragen konfigurieren müssen. Wenn Sie Initialisierungscode ausführen müssen, bevor Traffic verarbeitet wird, konfigurieren Sie Ihren Dienst so, dass er beim Start ausgeführt wird, bevor auf Anfragen gewartet wird, oder verwenden Sie Startprüfungen. Sie können auch Mindestinstanzen konfigurieren, um Instanzen einsatzbereit zu halten.

  • Benutzerdefinierte Fehlerseiten:

    error_handlers:
    - file: default_error.html
    - error_code: over_quota
      file: over_quota.html
    

    Lösung: Löschen Sie den Abschnitt error_handlers aus der Datei app.yaml und wenden Sie eine oder beide der folgenden Strategien an:

    • Implementieren Sie die Fehlerbehandlung direkt in Ihrem Anwendungscode. Fangen Sie Standard-HTTP-Fehlercodes wie 404 oder 500 ab und stellen Sie Ihre benutzerdefinierten HTML-Fehlerseiten über Ihre Anwendungslogik bereit.
    • Wenn Sie Cloud Load Balancing mit Cloud Run verwenden, konfigurieren Sie benutzerdefinierte Fehlerantworten auf Load-Balancer-Ebene. So können Sie benutzerdefinierte Fehlerseiten aus Cloud Storage basierend auf dem Antwortcode Ihres Cloud Run-Dienstes bereitstellen.
  • URL- und statische Dateihandler:

    handlers:
    - url: /stylesheets
      static_dir: stylesheets
    

    Lösung: Löschen Sie den Abschnitt handlers aus der Datei app.yaml oder behalten Sie nur einen Catch-all-Handler bei, der den gesamten Traffic an Ihre Anwendung weiterleitet (url: /.* oder url: .* mit script: auto). Cloud Run unterstützt kein app.yaml-Anfrage-Routing oder statische Datei-Handler. Stellen Sie stattdessen statische Dateien direkt über Ihren Cloud Run-Dienst oder über Cloud Storage bereit und verarbeiten Sie das URL-Routing in Ihrem Anwendungscode oder mithilfe von Cloud Load Balancing.

  • Build-Umgebungsvariablen:

    build_env_variables:
      BUILD_MODE: "production"
    

    Bei der Kompatibilitätsprüfung im Migrations-Hub wird diese Konfiguration als blockierende Inkompatibilität gemeldet. Der Befehl gcloud beta app migrate-to-run meldet sie nicht und wendet die Variablen auf den Build an, wenn Sie die Bereitstellung aus der Quelle vornehmen.

    Lösung: Löschen Sie den Abschnitt build_env_variables aus der Datei app.yaml. Wenn Ihr Build diese Werte weiterhin benötigt, legen Sie Build-Umgebungsvariablen fest, wenn Sie Ihren Cloud Run-Dienst aus der Quelle bereitstellen. Wenn Ihre Anwendung diese Werte zur Laufzeit benötigt, legen Sie sie als Umgebungsvariablen für den Dienst fest.

  • Einfache Skalierung:

    basic_scaling:
      max_instances: 10
      idle_timeout: 10m
    

    Cloud Run hat keine Einstellung für die einfache Skalierung. Der Migrationsbefehl zeigt eine Warnung an und verwendet den Wert max_instances als maximale Anzahl von Instanzen für Ihren Cloud Run-Dienst.

    Lösung: Prüfen Sie, ob das Autoscaling von Cloud Run Ihren Anforderungen entspricht.

  • Ressourcen- und Skalierungswerte außerhalb der Cloud Run-Limits:

    manual_scaling:
      instances: 1500
    

    Bei der Migration wird eine Warnung angezeigt, wenn Ihre Konfiguration außerhalb der folgenden Cloud Run-Limits liegt:

    • CPU: 8 vCPUs
    • Arbeitsspeicher: 512 MiB bis 32 GiB
    • Mindest-, Höchst- oder manuelle Skalierungsinstanzen: 1.000
    • Gleichzeitige Anfragen pro Instanz: 1.000

    Lösung: Aktualisieren Sie die Datei app.yaml, um Werte innerhalb dieser Limits zu verwenden. Weitere Informationen finden Sie unter CPU-Limits, Arbeitsspeicherlimits und Nebenläufigkeit. Wenn Sie mehr als 1.000 Instanzen benötigen, fordern Sie eine Kontingenterhöhung an.

Nächste Schritte