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:
-
Rolle Cloud Run Entwickler (
roles/run.developer
) im Cloud Run-Job -
Dienstkontonutzer (
roles/iam.serviceAccountUser
) für die Dienstidentität
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
Wechseln Sie in der Google Cloud Console zur Seite "Cloud Run-Jobs":
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.
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.
gcloud
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
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
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
und10
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:
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":
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.
gcloud
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.