設定工作的平行處理數量

您可以使用 parallelism 指定工作執行作業中可同時執行的工作數量上限。根據預設，系統會盡快啟動工作，最多可達上限，具體數量取決於您使用的 CPU 數量。

降低平行處理量會限制並行執行的工作數量。當某個備援資源 (例如資料庫) 的縮放功能有限，無法處理大量並行要求時，這項功能就很實用。

必要的角色

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

  • Cloud Run 工作中的 Cloud Run 開發人員 (roles/run.developer)
  • 服務身分上的「服務帳戶使用者」 (roles/iam.serviceAccountUser)

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

設定平行處理

如要為 Cloud Run 工作指定平行處理數量，請按照下列步驟操作：

控制台

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

    前往 Cloud Run

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

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

  4. 點選「一般」分頁標籤。

    圖片

    • 選取「盡可能同時處理更多工作」，以獲得最佳效能。如果您需要降低並行任務數量 (例如，如果您的後端資源有限)，請選取「限制並行任務數量」，然後指定介於 0 和配額允許的最大並行運作任務數量之間的整數，且該數量不得超過任務數量。

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

gcloud

  1. 針對您要建立的工作：

    gcloud run jobs create JOB_NAME --image IMAGE_URL --parallelism PARALLELISM

    取代

    • JOB_NAME 改為工作名稱。
    • IMAGE_URL，其中包含容器映像檔的參照，例如 us-docker.pkg.dev/cloudrun/container/job:latest。
    • PARALLELISM 的整數值介於 0 和配額允許的最大並行執行的工作數量之間，且不超過工作數量。

  2. 針對要更新的工作：

    gcloud run jobs update JOB_NAME --parallelism PARALLELISM

YAML

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

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

  2. 更新 parallelism: 屬性：

    apiVersion: run.googleapis.com/v1
kind: Job
metadata:
  name: JOB_NAME
spec:
  template:
    spec:
      parallelism: PARALLELISM
      template:
        spec:
          containers:
          - image: IMAGE

    取代 PARALLELISM。指定介於 0 和配額允許的最大同時執行的工作數量，且不得超過工作數量。

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

  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-parallelism"
  location = "us-central1"

  deletion_protection = false # set to "true" in production

  template {
    task_count  = 3
    parallelism = 3

    template {
      containers {
        image = "us-docker.pkg.dev/cloudrun/container/job:latest"
      }
    }
  }
}

查看平行處理設定

如要查看 Cloud Run 工作目前的並行設定，請按照下列步驟操作：

控制台

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

    前往 Cloud Run 工作

  2. 按一下您感興趣的工作，即可開啟「Job Details」(工作詳細資料) 頁面。

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

  4. 在設定詳細資料中找出平行處理設定。

gcloud

  1. 使用下列指令：

    gcloud run jobs describe JOB_NAME

  2. 在傳回的設定中找出平行處理設定。