Jobs wiederholen

Wenn ein Cloud Scheduler-Job keine Bestätigung von seinem Handler erhält, gilt der Job standardmäßig als fehlgeschlagen und wird gemäß dem von Ihnen konfigurierten exponentiellen Backoff wiederholt. Sie können dieses Wiederholungsverhalten beim Erstellen oder Aktualisieren eines Cloud Scheduler-Jobs auf folgende Weise festlegen:

Einstellungen für Wiederholungsversuche

In den folgenden Tabellen werden die Wiederholungseinstellungen beschrieben, die Sie konfigurieren können.

Maximale Wiederholungsversuche

Die Anzahl der Versuche, die das System unternimmt, um einen Job mit dem in maxDoublings beschriebenen exponentiellen Backoff-Verfahren auszuführen.

Beschreibung

Wenn retryCount auf eine Zahl ungleich null festgelegt ist, wiederholt Cloud Scheduler den fehlgeschlagenen Job mit exponentiellem Backoff retryCount-mal, bis der Job erfolgreich ist oder die Anzahl der Wiederholungsversuche erschöpft ist. Beachten Sie, dass die nächste geplante Ausführungszeit möglicherweise übersprungen wird, wenn die Wiederholungsversuche bis zu diesem Zeitpunkt fortgesetzt werden.

Wenn retryCount 0 ist (und wenn maxRetryDuration ebenfalls 0 ist), wird ein Jobversuch nicht wiederholt, wenn er fehlschlägt. Stattdessen wartet Cloud Scheduler auf die nächste geplante Ausführungszeit.

Werte über 5 und negative Werte sind nicht zulässig.

Standard Der Standardwert ist 0.
Konsolenlabel Maximale Wiederholungsversuche
Befehlszeilen-Flag --max-retry-attempts
API-Feld retryCount

Maximale Wiederholungsdauer

Das Zeitlimit für die Wiederholung eines fehlgeschlagenen Jobs, gemessen ab dem Zeitpunkt, zu dem eine Ausführung zum ersten Mal versucht wurde. Wenn Sie retryCount angeben, wird der Job wiederholt, bis beide Limits erreicht sind.

Beschreibung

Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die mit „s“ endet, z. B. „3.5s“.

Eine Dauer von 0 bedeutet, dass die Wiederholungsdauer unbegrenzt ist. Wenn retryCount jedoch auch 0 ist, wird ein Jobversuch nicht wiederholt, wenn er fehlschlägt.

Standard Der Standardwert ist 0 Sekunden.
Konsolenlabel Maximale Wiederholungsdauer
Befehlszeilen-Flag --max-retry-duration
API-Feld maxRetryDuration

Minimale Backoff-Dauer

Die Mindestwartezeit, bevor die Ausführung eines Jobs nach einem Fehlversuch wiederholt wird.

Beschreibung

Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die mit „s“ endet, z. B. „3.5s“.

Standard Standardwert: 5 Sekunden.
Konsolenlabel Minimale Backoff-Dauer
Befehlszeilen-Flag --min-backoff
API-Feld minBackoffDuration

Maximale Backoff-Dauer

Die maximale Wartezeit, bevor die Ausführung eines Jobs nach einem Fehlversuch wiederholt wird.

Beschreibung

Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die mit „s“ endet, z. B. „3.5s“.

Standard Der Standardwert beträgt 3.600 Sekunden (1 Stunde).
Konsolenlabel Maximale Backoff-Dauer
Befehlszeilen-Flag --max-backoff
API-Feld maxBackoffDuration

Maximale Anzahl Wiederholungen

Maximale Anzahl der Verdoppelungen des Intervalls zwischen Wiederholungsversuchen für fehlgeschlagene Jobs, bevor die Erhöhung konstant wird.

Beschreibung Die Zeit zwischen Wiederholungen wird maxDoublings-mal verdoppelt.

Das Wiederholungsintervall eines Jobs beginnt bei minBackoffDuration, verdoppelt sich dann maxDoublings-mal, steigt dann linear an und wird schließlich in Intervallen von maxBackoffDuration bis zu retryCount-mal wiederholt. Beispiel:

Wenn minBackoffDuration 10 Sekunden, maxBackoffDuration 300 Sekunden und maxDoublings 3 ist:

  1. Der Job wird zuerst in 10 Sekunden wiederholt.
  2. Das Wiederholungsintervall wird dreimal verdoppelt.
  3. Das Wiederholungsintervall erhöht sich dann linear um 2^3 * 10 s.
  4. Falls zutreffend, wird der Job in Intervallen von maxBackoffDuration wiederholt, bis der Job retryCount-mal versucht wurde (maximal 5-mal).

Die Anfragen werden also nach 10 s, 20 s, 40 s, 80 s und 160 s wiederholt.

Wenn minBackoffDuration 10 Sekunden, maxBackoffDuration 120 Sekunden und maxDoublings 2 ist:

  1. Der Job wird zuerst in 10 Sekunden wiederholt.
  2. Das Wiederholungsintervall wird zweimal verdoppelt.
  3. Das Wiederholungsintervall erhöht sich dann linear um 2^2 * 10 s.
  4. Falls zutreffend, wird der Job in Intervallen von maxBackoffDuration wiederholt, bis der Job retryCount-mal versucht wurde (maximal 5-mal).

Die Anfragen werden also nach 10 s, 20 s, 40 s, 80 s und 120 s wiederholt.

Standard Der Standardwert ist 5.
Konsolenlabel Maximale Anzahl Wiederholungen
Befehlszeilen-Flag --max-doublings
API-Feld maxDoublings

Beispiele für Wiederholungen

Die folgenden Beispiele zeigen das Wiederholungsverhalten, wenn ein Cloud Scheduler-Job nicht erfolgreich abgeschlossen wird.

Wenn sowohl retryCount als auch maxRetryDuration nicht festgelegt sind

Beide Einstellungen sind standardmäßig auf 0 gesetzt und der Job wird überhaupt nicht wiederholt.

Beachten Sie, dass Cloud Scheduler versucht, den Job zum nächsten geplanten Ausführungszeitpunkt auszuführen.

Wenn sowohl retryCount als auch maxRetryDuration festgelegt sind

Der Job wird mindestens retryCount-mal wiederholt, bis maxRetryDuration erreicht ist.

Beachten Sie, dass der Job möglicherweise öfter wiederholt wird als die retryCount.

Wenn retryCount festgelegt ist und maxRetryDuration nicht festgelegt ist

Die Einstellung maxRetryDuration ist standardmäßig auf 0 festgelegt und der Job wird genau retryCount-mal wiederholt.

Wenn retryCount nicht festgelegt ist und maxRetryDuration festgelegt ist

Der Job wird beliebig oft (bis zu fünfmal) oder bis zum Erreichen von maxRetryDuration wiederholt.

Nächste Schritte