手動調度工作站集區的資源

本頁說明如何手動調整工作站集區的資源配置。

總覽

手動資源調度功能可讓您設定特定執行個體數量，不必重新部署。您可以選擇使用外部系統，自行編寫縮放邏輯。如需相關範例，請參閱 Kafka 自動配置器。

使用手動調度資源時的帳單注意事項

使用手動調整資源配置時，即使您要求的執行個體處於閒置狀態，系統仍會將其視為運作中執行個體計費。如需完整的帳單詳細資料，請參閱定價頁面。

必要的角色

如要取得部署 Cloud Run worker 集區所需的權限，請要求管理員授予下列 IAM 角色：

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

設定資源調度

變更調度模式或手動執行個體計數不會建立新修訂版本。

如要設定縮放模式，請使用 Google Cloud 控制台、Google Cloud CLI、YAML 或 Terraform：

控制台

  1. 前往 Google Cloud 控制台的 Cloud Run：

    前往 Cloud Run

  2. 如要設定新的工作站集區，請從選單中選取「工作站集區」，然後按一下「部署容器」。如要設定現有工作者集區，請按一下工作者集區，顯示詳細資料窗格，然後按一下詳細資料面板右上角「Scaling」(調整規模) 旁的筆圖示。

  3. 找到「Scaling」(資源調度) 表單 (適用於新的工作站集區)，或是現有工作站集區的「Edit scaling」(編輯資源調度) 表單。

    圖片

  4. 在標示為「Number of instances」(執行個體數量) 的欄位中，指定服務的容器執行個體數量。

  5. 完成規格。

  6. 按一下「建立」即可建立新的工作站集區，按一下「儲存」即可儲存現有的工作站集區。

gcloud

如要為新的工作站集區指定資源調度，請使用 deploy 指令：

gcloud beta run worker-pools deploy WORKER_POOL \
    --scaling=INSTANCE_COUNT \
    --image IMAGE_URL

更改下列內容：

  • WORKER_POOL：工作站集區的名稱。
  • INSTANCE_COUNT：工作站集區的執行個體數量。 這會將 worker 集區設為手動資源調度。指定 0 的值，即可停用工作站集區。
  • IMAGE_URL：包含工作站集區的容器映像檔參照，例如 us-docker.pkg.dev/cloudrun/container/worker-pool:latest。

使用下列更新指令，為現有工作站集區指定資源調度：

gcloud beta run worker-pools update WORKER_POOL \
   --scaling=INSTANCE_COUNT

YAML

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

    gcloud beta run worker-pools describe WORKER_POOL --format export > workerpool.yaml

  2. 以下範例包含 YAML 設定：

    apiVersion: run.googleapis.com/v1
kind: WorkerPool
metadata:
  name: WORKER_POOL
  annotations:
    run.googleapis.com/launch-stage: BETA
    run.googleapis.com/manualInstanceCount: `INSTANCE_COUNT`

    更改下列內容：

    • WORKER_POOL：Cloud Run worker 集區的名稱。
    • INSTANCE_COUNT：您為工作站集區手動調整的執行個體數量。指定 0 值即可停用工作站集區。

  3. 使用下列指令建立或更新工作站集區：

    gcloud beta run worker-pools replace workerpool.yaml

Terraform

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

resource "google_cloud_run_v2_worker_pool" "default" {
  name     = "WORKER_POOL"
  location = "REGION"
  launch_stage = "BETA"

  template {
    containers {
      image = "IMAGE_URL"
    }
  }
  scaling {
    scaling_mode = "MANUAL"
    manual_instance_count = "INSTANCE_COUNT"
  }
}

更改下列內容：

  • WORKER_POOL：工作站集區的名稱。
  • REGION： Google Cloud 區域，例如 europe-west1。
  • IMAGE_URL：包含工作站集區的容器映像檔參照，例如 us-docker.pkg.dev/cloudrun/container/worker-pool:latest。
  • INSTANCE_COUNT：工作站集區的執行個體數量。 這會將 worker 集區設為手動資源調度。指定 0 值即可停用工作站集區。

查看 worker 集區的資源調度設定

  1. 前往 Google Cloud 控制台的 Cloud Run：

    前往 Cloud Run

  2. 按一下「工作站集區」，即可顯示已部署的工作站集區清單。

  3. 按一下要檢查的 worker 集區，顯示詳細資料窗格。

  4. 目前的資源調度設定會顯示在 worker 集區修訂版本清單上方： 「資源調度：手動 (執行個體：)」。

停用工作站集區

如要停用工作站集區，請使用下列指令將縮放比例設為零：

gcloud beta run worker-pools update WORKER_POOL --scaling=0

將 WORKER_POOL 替換為工作站集區的名稱。