Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

App Engine-Anwendung in der flexiblen Umgebung 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 dieser Anleitung wird beschrieben, wie Sie Ihre vorhandenen Anwendungen in der flexiblen Umgebung in Cloud Run bereitstellen.

Die in dieser Anleitung beschriebenen Schritte haben keine Auswirkungen auf die Funktionalität oder den Traffic-Fluss Ihrer vorhandenen App Engine-Anwendung. Der neu erstellte Cloud Run-Dienst ist eine Kopie des App Engine-Dienstes, den Sie unabhängig testen können.

Die flexible App Engine-Umgebung und Cloud Run sind beides vollständig verwaltete, containerbasierte Anwendungsplattformen, die sich jedoch strukturell unterscheiden. Weitere Informationen zu den Gemeinsamkeiten und Unterschieden zwischen App Engine und Cloud Run, einschließlich der Vorteile der Migration zu Cloud Run, finden Sie in der vergleichenden Zusammenfassung.

Wählen Sie eine der folgenden Strategien aus, um die Bereitstellung in Cloud Run durchzuführen:

Lokale Konfiguration einer app.yaml Datei (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 aktuellen lokalen Änderungen an Ihrem Code oder Ihrer Konfiguration in die neue Bereitstellung aufgenommen werden.
Ein 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. Dies ist nützlich, wenn Sie das Verhalten der aktiven Bereitstellung ohne Codeänderungen überprüfen möchten.

Hinweis

Achten Sie darauf, dass Ihre App Engine-Anwendung ohne Fehler ausgeführt wird. Sie benötigen Zugriff auf den App Engine-Quellcode, wenn Sie die Bereitstellung mit Ihrer lokalen Konfiguration durchführen möchten.
Aktivieren Sie die Cloud Run Admin API und die Artifact Registry API:

APIs aktivieren
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.
Prüfen Sie Ihre Anwendung auf inkompatible Funktionen und entfernen Sie sie, 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 aus:
```
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.
Prüfen Sie die folgenden Unterschiede bei Cloud Run:
- In Cloud Run wird der Begriff Revision anstelle von Version verwendet, um jede Bereitstellung von Änderungen für einen bestimmten Dienst darzustellen. Wenn Sie Ihre App zum ersten Mal in einem Cloud Run-Dienst bereitstellen, wird die erste Revision erstellt. Bei jeder nachfolgenden Bereitstellung eines Dienstes wird eine weitere Revision erstellt. Weitere Informationen zur Bereitstellung in Cloud Run.
- Sie können Ihren Quellcode mit der gcloud CLI in Cloud Run bereitstellen, um Ihre App Einstellungen 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 run.app Domain 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 und erfordern eine Konfiguration für den öffentlichen (nicht authentifizierten) Zugriff.

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 Bereitstellerkonto und dem Cloud Build-Dienstkonto die folgenden IAM-Rollen zuweisen.

Klicken, um die erforderlichen Rollen für das Bereitstellerkonto 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-Quellcodeentwickler (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 Standard-Cloud Build-Dienstkonto, um Ihren Quellcode und Ihre Cloud Run-Ressource zu erstellen, es sei denn, Sie überschreiben dieses Verhalten. 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 Ihrer Projekt-ID und 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.

Hinweis

Die iam.automaticIamGrantsForDefaultServiceAccounts Einschränkung für die Organisationsrichtlinie verhindert, dass die Rolle „Bearbeiter“ automatisch Standarddienstkonten zugewiesen wird. Wenn Sie Ihre Organisation nach dem 3. Mai 2024 erstellt haben, wird diese Einschränkung standardmäßig erzwungen.

Wir empfehlen dringend, diese Einschränkung zu erzwingen, um die automatische Rollenzuweisung zu deaktivieren. Wenn Sie die automatische Rollenzuweisung deaktivieren, müssen Sie entscheiden, welche Rollen den Standarddienstkonten zugeteilt werden sollen, und diese Rollen dann selbst zuweisen.

Wenn das Standarddienstkonto bereits die Rolle „Bearbeiter“ hat, sollten Sie die Rolle „Bearbeiter“ durch weniger strikte Rollen ersetzen.Verwenden Sie zum sicheren Ändern der Rollen des Dienstkontos Policy Simulator, um die Auswirkungen der Änderung zu sehen, und weisen Sie die entsprechenden Rollen zu und widerrufen Sie sie.

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 mit Google 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

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

Wechseln Sie im Terminal zu Ihrem Quellverzeichnis, in dem sich die Datei app.yaml befindet.
Stellen Sie die Anwendung mit dem folgenden Befehl in Cloud Run bereit:
```
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 Ihre app.yaml-Datei gespeichert. Weitere Informationen finden Sie unter gcloud beta app migrate-to-run.
- Wenn Sie aufgefordert werden, mit der Bereitstellung fortzufahren (Proceed with the deployment?), geben Sie Y ein, um ein Container-Image aus Ihrem Quellcode zu erstellen und den Dienst in Cloud Run bereitzustellen.
Rufen Sie den bereitgestellten Cloud Run-Dienst auf. Dazu öffnen Sie in einem Webbrowser die Dienst-URL.

Optional:
- Wenn sich Ihre app.yaml-Datei 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 zu Ihrer app.yaml-Datei.
- Führen Sie den folgenden Befehl aus, um die Cloud Run-Konfiguration service.yaml zu generieren und zu exportieren, ohne den Dienst bereitzustellen:
```
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.

Ein zuvor erstelltes Image verwenden

Wenn Sie ein zuvor erstelltes Container-Image aus einer bereitgestellten App Engine-Version verwenden möchten, anstatt das Container-Image aus einer lokalen app.yaml-Datei neu zu erstellen, gehen Sie so vor:

Für diese Bereitstellung benötigen Sie den Quellcode Ihrer Anwendung nicht.

Stellen Sie die Anwendung mit dem folgenden Befehl in Cloud Run bereit: Mit diesem Befehl wird das Container-Image einer aktiven App Engine-Bereitstellung verwendet und es werden keine aktuellen Änderungen aus Ihrer lokalen app.yaml-Datei erfasst. 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 aufgefordert werden, mit der Bereitstellung fortzufahren (Proceed with the deployment?), geben Sie Y ein, um Ihr vorhandenes App Engine-Container-Image zu exportieren und den Dienst in Cloud Run bereitzustellen.
Rufen Sie den bereitgestellten Cloud Run-Dienst auf. Dazu öffnen Sie in einem Webbrowser die Dienst-URL.

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 service.yaml Datei speichern möchten.

Inkompatible Features

Der Migrationsbefehl schlägt fehl, wenn Ihre app.yaml-Datei die folgende nicht unterstützte Konfiguration enthält:

Eingehende Dienste:
```
inbound_services:
- warmup
```
Lösung: Löschen Sie den Abschnitt inbound_services aus Ihrer app.yaml Datei. In Cloud Run werden Instanzen mit dem Containereinstiegspunkt aufgewärmt. Sie müssen also keine Aufwärmanfragen konfigurieren. Wenn Sie Initialisierungscode ausführen müssen, bevor Sie Traffic bereitstellen, konfigurieren Sie Ihren Dienst so, dass er beim Start ausgeführt wird, bevor Anfragen verarbeitet werden, oder verwenden Sie Start prüfungen. Sie können auch Mindestinstanzen konfigurieren, um Instanzen aufzuwärmen.

Nächste Schritte

Informationen zum Verwalten Ihrer Cloud Run-Dienste.
Informationen zu den Anforderungen und Verhaltensweisen von Containern in Cloud Run finden Sie im Cloud Run-Containervertrag.
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.