Ausführungsumgebung auswählen (Dienste)

Auf dieser Seite wird beschrieben, wie Sie die Ausführungsumgebung für jede Cloud Run-Instanz angeben. Bei Cloud Run-Diensten werden die Cloud Run-Instanzen standardmäßig in der Ausführungsumgebung der ersten Generation ausgeführt. Sie können diese Einstellung nur für Dienste ändern. Beachten Sie, dass Cloud Run-Jobs automatisch 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.

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.

Standardmäßig verwendet jede Instanz für Cloud Run-Dienste die Ausführungsumgebung der ersten Generation. Wenn Sie die zweite Generation verwenden, müssen Sie außerdem 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.

    Image

    • Wählen Sie die gewünschte Ausführungsumgebung mit den Optionsschaltflächen aus.
  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

Sie können vorhandene Dienstkonfigurationen mit dem Befehl gcloud run services describe --format export herunterladen und aufrufen, was bereinigte Ergebnisse im YAML-Format liefert. Anschließend können Sie die unten beschriebenen Felder ändern und die geänderte YAML-Datei mit dem Befehl gcloud run services replace hochladen. Achten Sie darauf, dass Sie die Felder nur wie dokumentiert ändern.

  1. So rufen Sie die Konfiguration auf und laden sie 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
          name: REVISION

    Ersetzen Sie

    • SERVICE durch den Namen Ihres Cloud Run-Dienstes.
    • 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.
    • REVISION durch einen neuen Überarbeitungsnamen oder löschen (falls vorhanden). Wenn Sie einen neuen Überarbeitungsnamen angeben, muss er die folgenden Kriterien erfüllen:
      • Beginnt mit SERVICE-
      • Enthält nur Kleinbuchstaben, Ziffern und -
      • Endet nicht mit -
      • Darf nicht mehr als 63 Zeichen enthalten
  3. Ersetzen Sie den Dienst mit dem folgenden Befehl durch die neue Konfiguration:

    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.