設定工作的重試次數上限

Cloud Run 工作包含一或多個工作。「重試次數上限」設定會指定工作在永久失敗前，因失敗而允許重新啟動的次數。預設值為 3。

這項設定適用於每個工作，而非每個作業。如果將此值設為 0，工作只會執行一次，失敗時不會重試。

必要的角色

如要取得設定 Cloud Run 作業所需的權限，請要求管理員授予下列 IAM 角色：

如需與 Cloud Run 相關聯的 IAM 角色和權限清單，請參閱 Cloud Run IAM 角色和 Cloud Run IAM 權限。如果 Cloud Run 作業與Google Cloud API (例如 Cloud 用戶端程式庫) 介接，請參閱服務身分設定指南。 如要進一步瞭解如何授予角色，請參閱部署權限和管理存取權。

設定重試次數上限

如要指定重試次數上限，請執行下列步驟：

控制台

  1. 前往 Google Cloud 控制台的 Cloud Run 作業頁面：

    前往 Cloud Run

  2. 從選單中選取「工作」，然後按一下「部署容器」，填寫初始工作設定頁面。如要設定現有工作，請選取該工作，然後按一下「編輯」。

  3. 按一下「容器、磁碟區、連線與安全性」，展開工作屬性頁面。

  4. 按一下「一般」分頁標籤。

    圖片

    • 使用介於 0 至 10 的整數指定重試次數。

  5. 按一下「建立」或「更新」。

gcloud

  1. 建立工作時：

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

    取代

    • JOB_NAME 改為您的工作名稱。
    • IMAGE_URL，並參照容器映像檔，例如 us-docker.pkg.dev/cloudrun/container/job:latest。
    • RETRY，並指定重試次數：指定介於 0 到 10 之間的整數。

  2. 如要更新工作：

    gcloud run jobs update JOB_NAME --max-retries RETRY

YAML

  1. 如果您要建立新工作，請略過這個步驟。 如要更新現有工作，請下載其 YAML 設定：

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

  2. 更新 maxRetries: 屬性：

    apiVersion: run.googleapis.com/v1
kind: Job
metadata:
  name: JOB
spec:
  template:
    spec:
      template:
        spec:
          containers:
          - image: IMAGE
          maxRetries: RETRIES

    將 RETRIES 替換為重試次數：指定介於 0 到 10 的整數。

    您也可以指定更多設定，例如環境變數或記憶體限制。

  3. 更新現有工作設定：

    gcloud run jobs replace job.yaml

Terraform

如要瞭解如何套用或移除 Terraform 設定，請參閱「基本 Terraform 指令」。

在 Terraform 設定中，將下列項目新增至 google_cloud_run_v2_job 資源：

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"
      }
    }
  }
}

查看重試次數上限設定

如要查看 Cloud Run 工作的目前重試次數上限設定，請執行下列步驟：

控制台

  1. 前往 Google Cloud 控制台的 Cloud Run 作業頁面：

    前往 Cloud Run jobs

  2. 按一下所需工作，開啟「工作詳細資料」頁面。

  3. 按一下「查看及編輯工作設定」。

  4. 在設定詳細資料中找出重試次數上限設定。

gcloud

  1. 使用下列指令：

    gcloud run jobs describe JOB_NAME

  2. 在傳回的設定中找出重試次數上限設定。