Ausführungsumgebung auswählen (Dienste)

Auf dieser Seite wird beschrieben, wie Sie die Ausführungsumgebung von Cloud Run-Instanzen angeben. Für Cloud Run-Dienste ist standardmäßig keine Ausführungsumgebung angegeben. Das bedeutet, dass Cloud Run die Ausführungsumgebung anhand der verwendeten Features auswählt. Wenn Sie keine Ausführungsumgebung für Ihren Dienst angeben, kann Cloud Run entweder die Umgebung der ersten Generation oder die zweite Generation auswählen.

Beachten Sie, dass Cloud Run-Jobs nur die Ausführungsumgebung der zweiten Generation verwenden und dies für Jobs nicht geändert werden kann.

In der Dokumentation zu den Ausführungsumgebungen finden Sie Informationen zur Auswahl der Umgebung, die für Ihren Dienst am besten geeignet ist.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zu gewähren, um die Berechtigungen zu erhalten, die Sie zum Konfigurieren und Bereitstellen von Cloud Run-Diensten benötigen:

• Cloud Run Developer (roles/run.developer) im Cloud Run-Dienst
• Dienstkontonutzer (roles/iam.serviceAccountUser) für die Dienstidentität

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 Service 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.

Ausführungsumgebung festlegen und aktualisieren

Jede Konfigurationsänderung führt zur Erstellung einer neuen Überarbeitung. Für nachfolgende Überarbeitungen gilt automatisch dieselbe Konfigurationseinstellung, sofern Sie sie nicht explizit aktualisieren.

Der Standard für Cloud Run-Dienste ist nicht angegeben. Das bedeutet, dass Cloud Run eine geeignete Ausführungsumgebung auswählt. Alternativ können Sie eine Ausführungsumgebung angeben. Zur Verwendung der zweiten Generation müssen Sie mindestens 512 MiB Arbeitsspeicher angeben.

Sie können die Ausführungsumgebung mit der Google Cloud Console, der gcloud-Befehlszeile oder einer YAML-Datei festlegen, wenn Sie einen neuen Dienst erstellen oder eine neue Überarbeitung bereitstellen:

Console

1. Rufen Sie in der Google Cloud Console Cloud Run auf.

   Öffnen Sie Cloud Run.

2. Klicken Sie auf Dienst erstellen, wenn Sie einen neuen Dienst für die Bereitstellung konfigurieren. Wenn Sie einen vorhandenen Dienst konfigurieren möchten, klicken Sie auf den Dienst und dann auf Neue Überarbeitung bearbeiten und bereitstellen.

3. Wenn Sie einen neuen Dienst konfigurieren, füllen Sie die Seite mit den anfänglichen Diensteinstellungen wie gewünscht aus und klicken Sie dann auf Container, Netzwerk, Sicherheit, um die Seite zur Dienstkonfiguration zu maximieren.

4. Klicken Sie auf den Tab Container.

   

   • Wählen Sie die gewünschte Ausführungsumgebung mit den Optionsschaltflächen aus. Behalten Sie die Standardeinstellung bei, damit Cloud Run eine geeignete Ausführungsumgebung auswählen kann.

5. Klicken Sie auf Erstellen oder Bereitstellen.

Befehlszeile

Mit dem folgenden Befehl können Sie die Ausführungsumgebung für einen bestimmten Dienst aktualisieren:

gcloud run services update SERVICE --execution-environment ENVIRONMENT

Ersetzen Sie SERVICE durch den Namen Ihres Dienstes und ENVIRONMENT durch die gewünschte Ausführungsumgebung. Geben Sie den Wert gen1 für die erste Generation oder gen2 für die zweite Generation an.

Sie können die Ausführungsumgebung auch während der Bereitstellung mit dem folgenden Befehl festlegen:

gcloud run deploy --image IMAGE_URL --execution-environment ENVIRONMENT

Ersetzen Sie

• IMAGE_URL durch einen Verweis auf das Container-Image, z. B. us-docker.pkg.dev/cloudrun/container/hello:latest. Wenn Sie Artifact Registry verwenden, muss das Repository REPO_NAME bereits erstellt sein. Die URL hat die Form LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.
• ENVIRONMENT durch die gewünschte Ausführungsumgebung. Geben Sie den Wert gen1 für die erste Generation oder gen2 für die zweite Generation an.

YAML

1. Wenn Sie einen neuen Dienst erstellen, überspringen Sie diesen Schritt. Wenn Sie einen vorhandenen Dienst aktualisieren, laden Sie die zugehörige YAML-Konfiguration herunter:

   gcloud run services describe SERVICE --format export > service.yaml

2. Legen Sie die Annotation run.googleapis.com/execution-environment fest:

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: SERVICE
   spec:
     template:
       metadata:
         annotations:
           run.googleapis.com/execution-environment: ENVIRONMENT

   Ersetzen

   • SERVICE durch den Namen Ihres Cloud Run-Dienstes
   • ENVIRONMENT durch die ausgewählte Ausführungsumgebung. Geben Sie den Wert gen1 für die erste Generation oder gen2 für die zweite Generation an.

   Entfernen Sie die Annotation run.googleapis.com/execution-environment für das Standardverhalten.

3. Erstellen oder aktualisieren Sie den Dienst mit dem folgenden Befehl:

   gcloud run services replace service.yaml

Einstellungen für die Ausführungsumgebung aufrufen

So rufen Sie die aktuellen Einstellungen der Ausführungsumgebung für Ihren Cloud Run-Dienst auf:

Console

1. Rufen Sie in der Google Cloud Console Cloud Run auf.

   Öffnen Sie Cloud Run.

2. Klicken Sie auf den gewünschten Dienst, um die Seite Dienstdetails zu öffnen.

3. Klicken Sie auf den Tab Überarbeitungen.

4. Im Detailbereich rechts wird die Einstellung der Ausführungsumgebung auf dem Tab Container aufgeführt.

Befehlszeile

1. Verwenden Sie den folgenden Befehl:

   gcloud run services describe SERVICE

2. Suchen Sie in der zurückgegebenen Konfiguration die Einstellung für die Ausführungsumgebung.