Zeitlimit bei Anfrage festlegen (Dienste)

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Bei Cloud Run-Diensten gibt das Zeitlimit bei Anfrage die Zeit an, in der eine Antwort von in Cloud Run bereitgestellten Diensten zurückgegeben werden muss. Wenn innerhalb des festgelegten Zeitraums keine Antwort erfolgt, endet die Anfrage und der Fehler 504 wird ausgegeben.

Das Zeitlimit ist standardmäßig auf 5 Minuten eingestellt und kann auf bis zu 60 Minuten verlängert werden.

Sie können diese Einstellung ändern, wenn Sie ein Container-Image bereitstellen oder die Dienstkonfiguration aktualisieren.

Neben der Zeitüberschreitung bei Anfrage in Cloud Run sollten Sie außerdem prüfen, ob im Framework Ihrer Sprache eine eigene Zeitüberschreitung bei Anfrage festgelegt ist, die ebenfalls aktualisiert werden muss.

Zeitüberschreitung bei Anfrage 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.

Sie können das Zeitlimit bei Anfrage über die Google Cloud Console, die gcloud-Befehlszeile oder eine YAML-Datei festlegen, wenn Sie einen neuen Dienst erstellen oder eine neue Überarbeitung bereitstellen.

Console

  1. Ö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, Verbindungen, Sicherheit, um die Seite zur Dienstkonfiguration zu maximieren.

  4. Klicken Sie auf den Tab Container.

    Bild

  5. Geben Sie in das Feld Zeitlimit für Anfragen den Wert für die Zeitüberschreitung ein, die Sie in Sekunden verwenden möchten. Verwenden Sie Werte von 1 bis 3600 Sekunden oder zwischen 1 und 60 Minuten.

  6. Klicken Sie auf Erstellen oder Bereitstellen.

Befehlszeile

Mit dem folgenden Befehl können Sie jederzeit für eine bestimmte Überarbeitung die Zeitüberschreitung bei Anfrage aktualisieren:

gcloud run services update [SERVICE] --timeout=[TIMEOUT]

Ersetzen Sie

  • [SERVICE] durch den Namen des Dienstes.
  • [TIMEOUT] durch die gewünschte Zeit. Dies muss ein ganzzahliger Wert oder ein Wert für die absolute Dauer sein, beispielsweise 1m20s, d. h. 1 Minute und 20 Sekunden. Wenn Sie einen ganzzahligen Wert verwenden, wird als Einheit Sekunden angenommen. Der angegebene Wert muss unter 60 Minuten liegen.

Sie können die Zeitüberschreitung bei Anfrage auch während des Deployments mit folgendem Befehl festlegen:

gcloud run deploy --image IMAGE_URL --timeout=[TIMEOUT]

Ersetzen Sie:

  • IMAGE_URL durch einen Verweis auf das Container-Image, z. B. us-docker.pkg.dev/cloudrun/container/hello:latest.
  • [TIMEOUT] durch die gewünschte Zeit. Dies muss ein ganzzahliger Wert oder ein Wert für die Dauer sein, beispielsweise 1m20s, d. h., 1 Minute und 20 Sekunden. Wenn Sie einen ganzzahligen Wert verwenden, wird als Einheit Sekunden angenommen. Der angegebene Wert muss unter 60 Minuten liegen.

YAML

Sie können die vorhandene Dienstkonfiguration 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. Aktualisieren Sie das Attribut timeoutSeconds:

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
      name: SERVICE
    spec:
      template:
        metadata:
          name: REVISION
        spec:
          containers:
          - image: IMAGE
          timeoutSeconds: VALUE

    Ersetzen

    • SERVICE durch den Namen Ihres Cloud Run-Dienstes
    • IMAGE_URL durch einen Verweis auf das Container-Image, z. B. us-docker.pkg.dev/cloudrun/container/hello:latest.
    • VALUE durch das gewünschte Zeitlimit in Sekunden.
    • 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

Terraform

Fügen Sie einer google_cloud_run_service-Ressource in Ihrer Terraform-Konfiguration unter template.spec Folgendes hinzu: Ersetzen Sie 300 durch das gewünschte Anfragezeitlimit Ihres Dienstes (in Sekunden).

# Timeout
# https://cloud.google.com/run/docs/configuring/request-timeout
timeout_seconds = 300

Führen Sie die folgenden Schritte aus, um Ihre Terraform-Konfiguration in einem Google Cloud-Projekt anzuwenden:

  1. Rufen Sie Cloud Shell auf.
  2. Legen Sie das Google Cloud-Projekt fest, auf das Sie die Terraform-Konfiguration anwenden möchten:
    export GOOGLE_CLOUD_PROJECT=PROJECT_ID
    
  3. Erstellen Sie ein Verzeichnis und öffnen Sie eine neue Datei in diesem Verzeichnis. Der Dateiname muss die Erweiterung .tf haben, z. B. main.tf:
    mkdir DIRECTORY && cd DIRECTORY && nano main.tf
    
  4. Kopieren Sie das Beispiel in main.tf.
  5. Prüfen und ändern Sie die Beispielparameter, die auf Ihre Umgebung angewendet werden sollen.
  6. Speichern Sie die Änderungen, indem Sie Ctrl-x und dann y drücken.
  7. Initialisieren Sie Terraform:
    terraform init
  8. Prüfen Sie die Konfiguration und prüfen Sie, ob die Ressourcen, die Terraform erstellen oder aktualisieren wird, Ihren Erwartungen entsprechen:
    terraform plan

    Korrigieren Sie die Konfiguration nach Bedarf.

  9. Wenden Sie die Terraform-Konfiguration an. Führen Sie dazu den folgenden Befehl aus und geben Sie yes an der Eingabeaufforderung ein:
    terraform apply

    Warten Sie, bis Terraform die Meldung „Apply complete“ anzeigt.

  10. Öffnen Sie Ihr Google Cloud-Projekt, um die Ergebnisse aufzurufen. Rufen Sie in der Google Cloud Console Ihre Ressourcen in der Benutzeroberfläche auf, um sicherzustellen, dass Terraform sie erstellt oder aktualisiert hat.

Einstellungen für Zeitlimits bei Anfrage aufrufen

So rufen Sie die aktuellen Einstellungen für das Zeitlimit bei Anfrage für Ihren Cloud Run-Dienst auf:

Console

  1. Ö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 auf der rechten Seite ist die Zeitüberschreitungseinstellung bei Anfragen auf dem Tab Container aufgelistet.

Befehlszeile

  1. Verwenden Sie den folgenden Befehl:

    gcloud run services describe SERVICE
  2. Suchen Sie in der zurückgegebenen Konfiguration nach der Zeitüberschreitungseinstellung.