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.
In diesem Leitfaden wird beschrieben, wie Sie Ihre vorhandenen Anwendungen in der flexiblen Umgebung in Cloud Run bereitstellen.
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.
Die flexible App Engine-Umgebung und Cloud Run sind beide vollständig verwaltete, containerbasierte Anwendungsplattformen, unterscheiden sich jedoch strukturell. 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. Verwenden Sie die lokale Konfiguration Ihrerapp.yaml-Datei, um die Bereitstellung in Cloud Run vorzunehmen. Dadurch wird ein Container-Image aus Ihrem lokalen Quellcode erstellt, sodass alle kürzlich vorgenommenen Änderungen an Ihrem Code oder Ihrer Konfiguration in der neuen Bereitstellung enthalten sind.
Hinweis
Achten Sie darauf, dass Ihre App Engine-Anwendung fehlerfrei ausgeführt wird. Sie benötigen Zugriff auf Ihren App Engine-Quellcode.
Aktivieren Sie die Cloud Run Admin API und die Artifact Registry API:
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 updateErsetzen Sie Folgendes:
- PROJECT_ID: Projekt-ID in Google Cloud .
- REGION: die Region, in der Sie Ihren Cloud Run-Dienst bereitstellen möchten.
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.yamlbefindet:gcloud beta app migrate-to-run --dry-runPrüfen Sie die Ergebnisse der Kompatibilitätsprüfung und nehmen Sie bei Bedarf die empfohlenen Änderungen vor.
Sehen Sie sich die folgenden Cloud Run-Unterschiede an:
Cloud Run verwendet den Begriff
Revisionanstelle vonVersion, 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 RunSie 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.appin 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 flexible Umgebung 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:
- Cloud Run Source Developer (
roles/run.sourceDeveloper) für Ihr Projekt - Service Usage Consumer (
roles/serviceusage.serviceUsageConsumer) für Ihr Projekt - Dienstkontonutzer (
roles/iam.serviceAccountUser) für die Cloud Run-Dienstidentität
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.
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
Rufen Sie in der Google Cloud Console die Seite App Engine auf.
Klicken Sie im Navigationsmenü auf Migrations-Hub, um Ihre App Engine-Anwendung in Cloud Run bereitzustellen.
Wählen Sie auf der Karte Migration von flexibel zu Cloud Run den Dienst und die Version aus, die Sie migrieren möchten, und klicken Sie dann auf Kompatibilität prüfen.
Sehen Sie sich im Bereich Kompatibilität prüfen die Kompatibilitätsergebnisse an. Der Migrations-Hub führt einen Kompatibilitätscheck durch, um inkompatible Funktionen zu identifizieren.
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.
Kopieren Sie 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.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:
Wechseln Sie in Ihrem Terminal in das Quellverzeichnis, in dem sich die Datei
app.yamlbefindet.Führen Sie den folgenden Befehl aus, um Ihren Dienst in Cloud Run bereitzustellen:
gcloud beta app migrate-to-runMit diesem Befehl wird die
service.yaml-Dateikonfiguration für Cloud Run generiert und lokal im selben Verzeichnis wie dieapp.yaml-Datei gespeichert. Weitere Informationen finden Sie untergcloud beta app migrate-to-run.- Geben Sie bei der Aufforderung
Proceed with the deployment?den WertYein, um ein Container-Image aus Ihrem Quellcode zu erstellen und den Dienst in Cloud Run bereitzustellen.
- Geben Sie bei der Aufforderung
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 Forbiddenzurückgegeben. Führen Sie einen der folgenden Schritte aus, um Ihren Dienst aufzurufen:- Wenn Sie den Dienst privat testen möchten (empfohlen), führen Sie den Befehl
gcloud run services proxyaus und öffnen Sie dann die lokale Proxy-URL in einem Webbrowser. - Wenn Ihr Dienst öffentlich verfügbar sein soll, aktivieren Sie den öffentlichen Zugriff und öffnen Sie dann die Dienst-URL in einem Webbrowser.
Optional:
Wenn sich die Datei
app.yamlin einem anderen Verzeichnis befindet, geben Sie den Pfad mit dem Flag--appyamlan:gcloud beta app migrate-to-run --appyaml=PATHErsetzen Sie PATH durch den Pfad zur Datei
app.yaml.Wenn Sie die Cloud Run-Konfiguration
service.yamlgenerieren und exportieren möchten, ohne den Dienst bereitzustellen, verwenden Sie das Flag--export-only:gcloud beta app migrate-to-run --export-only=EXPORT_PATHErsetzen Sie EXPORT_PATH durch das Verzeichnis oder den Pfad, in dem Sie die Datei
service.yamlspeichern möchten.
- Wenn Sie den Dienst privat testen möchten (empfohlen), führen Sie den Befehl
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: - warmupLösung: Löschen Sie den Abschnitt
inbound_servicesaus der Dateiapp.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.htmlLösung: Löschen Sie den Abschnitt
error_handlersaus der Dateiapp.yamlund wenden Sie eine oder beide der folgenden Strategien an:- Implementieren Sie die Fehlerbehandlung direkt in Ihrem Anwendungscode. Fangen Sie Standard-HTTP-Fehlercodes wie
404oder500ab 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.
- Implementieren Sie die Fehlerbehandlung direkt in Ihrem Anwendungscode. Fangen Sie Standard-HTTP-Fehlercodes wie
URL- und statische Dateihandler:
handlers: - url: /stylesheets static_dir: stylesheetsLösung: Löschen Sie den Abschnitt
handlersaus der Dateiapp.yaml. Cloud Run unterstützt keinapp.yaml-Anfrage-Routing oder statische Dateihandler. 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-runmeldet 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_variablesaus der Dateiapp.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: 10mLösung: Ersetzen Sie den Abschnitt
basic_scalingin der Dateiapp.yamldurchautomatic_scalingodermanual_scaling. Die Kompatibilitätsprüfung im Migrations-Hub blockiert Versionen, die die einfache Skalierung verwenden.Ressourcen- und Skalierungswerte außerhalb der Cloud Run-Limits:
manual_scaling: instances: 1500Bei 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.
Weitergeleitete Ports mit Hostportzuordnungen, Protokollen oder mehreren Ports:
network: forwarded_ports: - 8080:8000 - 2222/udpLösung: Aktualisieren Sie
network.forwarded_portsin Ihrerapp.yaml-Datei, um nur einen einzelnen numerischen Containerport anzugeben, z. B.8080, oder löschen Sieforwarded_portsund konfigurieren Sie den Containerport in Cloud Run. Cloud Run akzeptiert nur eingehenden TCP-Traffic an einem einzelnen Containerport und unterstützt keine Host-zu-Container-Portzuordnungen oder UDP-Traffic. Das Migrationstool akzeptiert nur reine Portnummern. Host-Port-Zuordnungen und Protokollsuffixe wie/tcpoder/udp, z. B.8080/tcp, führen daher zu einem Fehlschlagen der Migration. Wenn Sie mehrere numerische Ports angeben, protokolliert das Migrationstool eine Warnung und konfiguriert nur den ersten Port.Laufwerksgröße:
resources: disk_size_gb: 20Lösung: Löschen Sie
disk_size_gbaus dem AbschnittresourcesIhrerapp.yaml-Datei. Das Migrationstool zeigt eine Warnung an und ignoriert diese Einstellung, da Cloud Run standardmäßig ein In-Memory-Dateisystem verwendet, bei dem das Schreiben von Dateien Instanzspeicher verbraucht. Wenn Ihre Anwendung Dateien schreiben muss, ohne Arbeitsspeicher zu verbrauchen, konfigurieren Sie in Cloud Run eine flüchtige Laufwerks-Volume-Bereitstellung oder eine Cloud Storage-Volume-Bereitstellung, um OOM-Fehler (Out-of-Memory) zu vermeiden.
Nächste Schritte
- Cloud Run-Dienste verwalten
- Informationen zu den Anforderungen und Verhaltensweisen von Containern in Cloud Run finden Sie im Cloud Run-Containerlaufzeitvertrag.
- Hier erfahren Sie, wie Sie Abhängigkeiten für Ihren Dienst mithilfe eines Secret Managers speichern, die API-Schlüssel, Passwörter oder andere vertrauliche Informationen erfordern.