Maximale Wiederholungsversuche für Jobs festlegen

Ein Cloud Run-Job besteht aus einer oder mehreren Aufgaben. Die maximale Wiederholungseinstellung gibt an, wie oft eine Aufgabe im Falle eines Fehlers neu gestartet werden darf, bevor sie dauerhaft fehlschlägt. Der Standardwert ist 3.

Diese Einstellung gilt pro Aufgabe, nicht pro Job. Wenn Sie 0 festlegen, werden Aufgaben nur einmal ausgeführt und bei einem Fehler nicht wiederholt.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Konfigurieren von Cloud Run-Jobs benötigen:

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

Maximale Anzahl an Wiederholungsversuchen konfigurieren

Sie können die maximale Anzahl von Wiederholungsversuchen für einen Cloud Run-Job über dieGoogle Cloud Console, die gcloud CLI, YAML oder Terraform konfigurieren:

Console

  1. Rufen Sie in der Google Cloud Console die Seite „Cloud Run“ auf:

    Zu Cloud Run

  2. Wählen Sie im Cloud Run-Navigationsmenü Jobs aus:

    1. Wenn Sie einen neuen Job erstellen, klicken Sie auf Container bereitstellen, um die Seite mit den anfänglichen Jobeinstellungen auszufüllen.

    2. Wenn Sie einen vorhandenen Job konfigurieren, wählen Sie den Job aus und klicken Sie dann auf Jobkonfiguration ansehen und bearbeiten.

  3. Klicken Sie auf Container, Verbindungen, Sicherheit, um die Seite mit den Jobattributen zu maximieren.

  4. Geben Sie im Abschnitt Aufgabenkapazität die Anzahl der Wiederholungen als Ganzzahl zwischen 0 und 10 an.

  5. Klicken Sie auf Erstellen oder Aktualisieren.

gcloud

  • Führen Sie den folgenden Befehl aus, um maximale Wiederholungsversuche festzulegen, wenn Sie einen neuen Job erstellen:

    gcloud run jobs create JOB --image IMAGE_URL --max-retries RETRY

    Ersetzen Sie Folgendes:

    • JOB: Der Name Ihres Cloud Run-Jobs.
    • IMAGE_URL: Ein Verweis auf das Container-Image, z. B. us-docker.pkg.dev/cloudrun/container/job:latest.
    • RETRY: Die Anzahl der Wiederholungsversuche. Geben Sie eine Ganzzahl zwischen 0 und 10 an.

  • Führen Sie den folgenden Befehl aus, um die maximale Anzahl von Wiederholungsversuchen für einen vorhandenen Job zu aktualisieren:

    gcloud run jobs update JOB --max-retries RETRY

YAML

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

    gcloud run jobs describe JOB --format export > job.yaml

  2. Aktualisieren Sie das Attribut maxRetries::

    apiVersion: run.googleapis.com/v1
kind: Job
metadata:
  name: JOB
spec:
  template:
    spec:
      template:
        spec:
          containers:
          - image: IMAGE_URL
          maxRetries: RETRY

    Ersetzen Sie Folgendes:

    • JOB: Der Name Ihres Cloud Run-Jobs.
    • IMAGE_URL: Ein Verweis auf das Container-Image, z. B. us-docker.pkg.dev/cloudrun/container/job:latest.
    • RETRY: Die Anzahl der Wiederholungsversuche. Geben Sie eine Ganzzahl zwischen 0 und 10 an.

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

    gcloud run jobs replace job.yaml

    Standardmäßig wird mit dem Befehl gcloud run jobs replace die Datei job.yaml verwendet, sofern sie vorhanden ist.

Terraform

Informationen zum Anwenden oder Entfernen einer Terraform-Konfiguration finden Sie unter Grundlegende Terraform-Befehle.

Fügen Sie einer google_cloud_run_v2_job-Ressource in Ihrer Terraform-Konfiguration Folgendes hinzu:
resource "google_cloud_run_v2_job" "default" {
  name     = "cloud-run-job-retries"
  location = "us-central1"

  deletion_protection = false # set to "true" in production

  template {
    template {
      max_retries = 3

      containers {
        image = "us-docker.pkg.dev/cloudrun/container/job:latest"
      }
    }
  }
}

Einstellungen für die maximale Anzahl an Wiederholungen aufrufen

So rufen Sie die aktuellen Einstellungen für die maximale Anzahl an Wiederholungsversuchen für Ihren Cloud Run-Job auf: Google Cloud

Console

  1. Wechseln Sie in der Google Cloud -Console zur Seite „Cloud Run-Jobs“:

    Zu Cloud Run-Jobs

  2. Klicken Sie auf den Job, um die Seite Jobdetails zu öffnen.

  3. Klicken Sie auf Jobkonfiguration ansehen und bearbeiten.

  4. Suchen Sie in den Konfigurationsdetails die Einstellung für die maximale Anzahl an Wiederholungsversuchen.

gcloud

  1. Führen Sie dazu diesen Befehl aus:

    gcloud run jobs describe JOB

  2. Suchen Sie in der zurückgegebenen Konfiguration nach der Einstellung für die maximale Anzahl von Wiederholungen.