重試工作

根據預設,如果 Cloud Scheduler 工作未收到處理常式的確認,系統會判定工作失敗,並根據您設定的指數輪詢重試。建立或更新 Cloud Scheduler 工作時,您可以透過下列方式決定這項重試行為:

重試設定

下表說明可設定的重試設定。

重試次數上限

系統會使用 maxDoublings 描述的指數輪詢程序,嘗試執行工作的次數。

說明

如果 retryCount 設為非零數字,Cloud Scheduler 會使用指數輪詢重試失敗的工作 retryCount 次,直到工作成功或重試次數用盡為止。請注意,如果重試作業持續到下次排定的執行時間,系統可能會略過該次執行。

如果 retryCount 為 0 (且 maxRetryDuration 也為 0),則工作嘗試失敗時不會重試。Cloud Scheduler 會等待下一個排定的執行時間。

不得輸入大於 5 的值和負值。

預設 預設值為 0。
控制台標籤 重試次數上限
CLI 旗標 --max-retry-attempts
API 欄位 retryCount

重試持續時間上限

重試失敗工作的時間限制,從首次嘗試執行時算起。如果與 retryCount 一併指定,系統會重試工作,直到達到這兩項限制。

說明

以秒為單位的時間長度,最多 9 個小數位數,結尾為「s」,例如「3.5s」。

如果時間長度為 0,表示重試時間長度沒有限制。不過,如果 retryCount 也是 0,則工作嘗試失敗時不會重試。

預設 預設值為 0 秒。
控制台標籤 重試持續時間上限
CLI 旗標 --max-retry-duration
API 欄位 maxRetryDuration

輪詢持續時間下限

工作失敗後,等待重試的時間下限。

說明

以秒為單位的時間長度,最多 9 個小數位數,結尾為「s」,例如「3.5s」。

預設 預設值為 5 秒。
控制台標籤 輪詢持續時間下限
CLI 旗標 --min-backoff
API 欄位 minBackoffDuration

輪詢持續時間上限

工作失敗後,等待重試的時間上限。

說明

以秒為單位的時間長度,最多 9 個小數位數,結尾為「s」,例如「3.5s」。

預設 預設值為 3,600 秒 (1 小時)。
控制台標籤 輪詢持續時間上限
CLI 旗標 --max-backoff
API 欄位 maxBackoffDuration

加倍次數上限

失敗工作重試間隔時間加倍的次數上限,超過這個次數後,間隔時間就會維持不變。

說明 重試的間隔時間會加倍 maxDoublings 次。

工作的重試間隔一開始為 minBackoffDuration,接著會加倍 maxDoublings 次,然後以線性方式增加,最後以 maxBackoffDuration 的間隔重試,最多 retryCount 次。例如:

如果 minBackoffDuration 為 10 秒,maxBackoffDuration 為 300 秒,maxDoublings 為 3:

  1. 10 秒後會首次重試工作。
  2. 重試間隔會加倍三次。
  3. 重試間隔會以 2^3 * 10 秒線性增加。
  4. 如果適用,工作會每隔 maxBackoffDuration 重試一次,直到嘗試 retryCount 次為止 (最多 5 次)。

因此,要求會在 10 秒、20 秒、40 秒、80 秒、160 秒後重試。

如果 minBackoffDuration 為 10 秒,maxBackoffDuration 為 120 秒,maxDoublings 為 2:

  1. 10 秒後會首次重試工作。
  2. 重試間隔會加倍兩次。
  3. 重試間隔會以 2^2 * 10 秒線性增加。
  4. 如果適用,工作會每隔 maxBackoffDuration 重試一次,直到嘗試 retryCount 次為止 (最多 5 次)。

因此,系統會在 10 秒、20 秒、40 秒、80 秒、120 秒後重試要求。

預設 預設值為 5。
控制台標籤 加倍次數上限
CLI 旗標 --max-doublings
API 欄位 maxDoublings

重試範例

以下範例說明 Cloud Scheduler 工作未順利完成時的重試行為。

如果未設定 retryCount 和 maxRetryDuration

這兩項設定的預設值均為 0,工作完全不會重試。

請注意,Cloud Scheduler 會嘗試在下一個排定的執行時間執行工作。

如果同時設定 retryCount 和 maxRetryDuration

工作會重試至少 retryCount 次,直到達到 maxRetryDuration 為止。

請注意,工作重試次數可能會超過 retryCount。

如果已設定 retryCount,但未設定 maxRetryDuration

maxRetryDuration 設定預設為 0,工作會重試 retryCount 次。

如果未設定 retryCount,但已設定 maxRetryDuration

工作會重試任意次數 (最多 5 次),或直到達到 maxRetryDuration 為止。

後續步驟