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.

So geben Sie maximale Wiederholungsversuche an:

Console

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

Öffnen Sie Cloud Run.
Klicken Sie auf den Tab Jobs und füllen Sie die Seite mit den anfänglichen Jobeinstellungen wie gewünscht aus, wenn Sie einen neuen Job konfigurieren. Klicken Sie auf den Job und dann auf Bearbeiten, wenn Sie einen vorhandenen Job konfigurieren.
Klicken Sie auf Container, Variablen und Secrets, Verbindungen, Sicherheit, um die Seite mit den Jobattributen zu maximieren.
Klicken Sie auf den Tab Allgemein.
- Geben Sie für die Anzahl der Wiederholungen eine Ganzzahl von 0 bis 10 an.
Klicken Sie auf Erstellen oder Aktualisieren.

Befehlszeile

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.

Für einen Job, den Sie aktualisieren:

gcloud run jobs update JOB_NAME --max-retries RETRY

YAML

Laden Sie die vorhandene Jobkonfiguration herunter und verwenden Sie den Befehl gcloud run jobs describe --format export, um bereinigte Ergebnisse im YAML-Format zu erhalten. Ändern Sie dann die unten beschriebenen Felder und laden Sie die geänderte YAML-Datei mit dem Befehl gcloud run jobs replace hoch. Achten Sie darauf, dass Sie die Felder nur wie dokumentiert ändern.

So rufen Sie die Konfiguration auf und laden sie herunter:

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

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.
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"
  launch_stage = "BETA"

  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

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

Zu Cloud Run-Jobs
Klicken Sie auf den gewünschten Job, um die Seite Jobdetails zu öffnen.
Klicken Sie auf den Tab Konfiguration.
Suchen Sie in den Konfigurationsdetails die Einstellung für die maximale Anzahl an Wiederholungsversuchen.

Befehlszeile

Verwenden Sie den folgenden Befehl:
```
gcloud run jobs describe JOB_NAME
```
Suchen Sie in der zurückgegebenen Konfiguration nach der Einstellung für die maximale Anzahl von Wiederholungen.