Maximale Wiederholungsversuche festlegen (Jobs)

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 zu gewähren, um die zum Konfigurieren von Cloud Run-Jobs erforderlichen Berechtigungen zu erhalten:

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

Maximale Anzahl von Wiederholungen konfigurieren

So geben Sie maximale Wiederholungsversuche an:

Console

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

    Zu Cloud Run

  2. Klicken Sie auf Container bereitstellen und wählen Sie Job aus, um die Seite mit den anfänglichen Jobeinstellungen auszufüllen. Wählen Sie den Job aus und klicken Sie dann auf Bearbeiten, wenn Sie einen vorhandenen Job konfigurieren.

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

  4. Klicken Sie auf den Tab Allgemein.

    Bild

    • Geben Sie für die Anzahl der Wiederholungen eine Ganzzahl von 0 bis 10 an.
  5. Klicken Sie auf Erstellen oder Aktualisieren.

gcloud

  1. Für einen Job, den Sie erstellen:

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

    Ersetzen

    • JOB_NAME durch den Namen des Jobs.
    • IMAGE_URL durch einen Verweis auf das Container-Image, z. B. us-docker.pkg.dev/cloudrun/container/job:latest.
    • RETRY durch die Anzahl der Wiederholungen: Geben Sie eine Ganzzahl zwischen 0 und 10 an.
  2. Für einen Job, den Sie aktualisieren:

    gcloud run jobs update JOB_NAME --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_NAME --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
              maxRetries: RETRIES

    Ersetzen Sie RETRIES durch die Anzahl der Wiederholungen: Geben Sie eine Ganzzahl zwischen 0 und 10 an.

    Sie können auch weitere Konfigurationen angeben, z. B. Umgebungsvariablen oder Speicherlimits.

  3. Aktualisieren Sie die vorhandene Jobkonfiguration:

    gcloud run jobs replace job.yaml

Terraform

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

Verwenden Sie die Ressource google_cloud_run_v2_job und wenden Sie das folgende Snippet auf Ihre main.tf-Datei an, um maximale Wiederholungsversuche für einen Cloud Run-Job anzugeben:

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:

Console

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

    Zu Cloud Run-Jobs

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

  3. Klicken Sie auf den Tab Konfiguration.

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

gcloud

  1. Verwenden Sie den folgenden Befehl:

    gcloud run jobs describe JOB_NAME
  2. Suchen Sie in der zurückgegebenen Konfiguration nach der Einstellung für die maximale Anzahl von Wiederholungen.