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

手動調度資源可讓您設定特定執行個體數量,而不必重新部署。如果工作負載需要固定數量的執行個體,或您想透過自己的系統控管執行個體數量,請使用手動調度資源。

如要根據 CPU 使用率自動調度執行個體資源,而非設定固定的執行個體數量,請參閱「設定 worker 集區的 CPU 自動調度資源功能」。

使用手動調度資源時的計費注意事項

使用手動調度資源時,系統會將您要求的所有執行個體視為「有效」執行個體並計費,即使這些執行個體剛好處於閒置狀態也一樣。如需完整的計費詳細資料,請參閱定價頁面。

必要的角色

如要取得設定及部署 Cloud Run worker 集區所需的權限,請要求管理員授予您下列 IAM 角色:

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

設定資源調度

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

如要設定縮放模式,請使用 Google Cloud 控制台、Google Cloud CLI、YAML、Terraform 或 REST API:

控制台

  1. 前往 Google Cloud 控制台的「Cloud Run」頁面:

    前往 Cloud Run。

  2. 如要設定新的 worker 集區,請從選單中選取「Worker pools」(Worker 集區),然後按一下「Deploy container」(部署容器)。如要設定現有的 worker 集區,請按一下 worker 集區,顯示詳細資料窗格,然後按一下詳細資料面板右上角「Scaling」(資源調度) 旁的筆形圖示。

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

    圖片

  4. 在「執行個體數量」欄位中,指定 worker 集區的容器執行個體數量。

  5. 完成規格。

  6. 按一下「建立」即可建立新的 worker 集區,或按一下「儲存」即可儲存現有的 worker 集區。

gcloud

  • 如要為新的 worker 集區指定手動調度資源,請執行下列指令,並加上 --scaling 旗標:
gcloud beta run worker-pools deploy WORKER_POOL \
    --scaling=INSTANCE_COUNT \
    --image IMAGE_URL

更改下列內容:

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

  • 如要為現有 worker 集區指定手動調度資源,請使用 --scaling 旗標執行下列指令:

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

更改下列內容:

  • WORKER_POOL:worker 集區的名稱。
  • INSTANCE_COUNT:worker 集區的執行個體數量。

YAML

  1. 如要建立新的 worker 集區,請略過這個步驟。如要更新現有 worker 集區,請下載其 YAML 設定:

    gcloud run worker-pools describe WORKER_POOL --format export > worker-pool.yaml
  2. 將 scalingMode 設為 manual,並指定 manualInstanceCount:

    apiVersion: run.googleapis.com/v1
    kind: WorkerPool
    metadata:
    name: WORKER_POOL
    annotations:
      run.googleapis.com/scalingMode: manual
      run.googleapis.com/manualInstanceCount: "INSTANCE_COUNT"

    更改下列內容:

    • WORKER_POOL:Cloud Run worker 集區的名稱。
    • INSTANCE_COUNT:手動為 worker 集區調整資源配置的執行個體數量。指定 0 值即可停用 worker 集區。
  3. 使用下列指令建立或更新 worker 集區:

    gcloud run worker-pools replace worker-pool.yaml

    gcloud run worker-pools replace 指令預設會使用 worker-pool.yaml 檔案 (如有)。

Terraform

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

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

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

更改下列內容:

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

REST API

如要更新特定 worker 集區的執行個體數量,請向 Cloud Run Admin API workerPools.patch 端點傳送 PATCH HTTP 要求:

curl -H "Content-Type: application/json" \
   -H "Authorization: Bearer ACCESS_TOKEN" \
   -X PATCH \
   -d '{"scaling":{"scalingMode":"MANUAL","manualInstanceCount":INSTANCE_COUNT}}' \
   https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/workerPools/WORKER_POOL?update_mask=scaling.scalingMode,scaling.manualInstanceCount

更改下列內容:

  • ACCESS_TOKEN:帳戶的有效存取權杖,該帳戶必須具備更新 worker 集區的 IAM 權限。舉例來說,如果您已登入 gcloud,可以使用 gcloud auth print-access-token 擷取存取權杖。在 Cloud Run 容器執行個體中,您可以使用容器執行個體中繼資料伺服器擷取存取權杖。
  • INSTANCE_COUNT:worker 集區的執行個體數量。
  • PROJECT_ID: Google Cloud 專案 ID。
  • REGION:部署 worker 集區的 Google Cloud 區域。
  • WORKER_POOL:worker 集區的名稱。

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

  1. 前往 Google Cloud 控制台的「Cloud Run」頁面:

    前往 Cloud Run。

  2. 按一下「Worker pools」(worker 集區),即可顯示已部署的 worker 集區清單。

  3. 按一下要檢查的工作站集區,顯示詳細資料窗格。

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

停用 worker 集區

如要停用 worker 集區,請執行下列指令並加上 --scaling=0 旗標:

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

將 WORKER_POOL 替換為 worker 集區名稱。

後續步驟