為服務設定執行個體數量下限

控制台

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

   前往 Cloud Run

2. 如果您要設定新服務，請從選單中選取「Services」，然後按一下「Deploy container」，顯示「Create service」表單。找到「Service scaling」(服務資源調度) 表單。

3. 如果您要設定現有服務，請按一下該服務來顯示詳細資料面板，然後點選詳細資料面板右上方的 edit「編輯服務層級資源調度設定」。

4. 在標示為「Minimum number of instances」的欄位中，指定要維持暖機狀態的容器執行個體數量，以便接收要求。

5. 如要建立新服務，請按一下「建立」，如要部署現有服務，請按一下「部署」。

gcloud

使用下列指令更新特定服務的執行個體數量下限：

gcloud run services update SERVICE --min MIN-VALUE

取代：

• SERVICE 改為您的服務名稱。
• MIN-VALUE 可讓您指定要保留的容器執行個體數量，以便接收要求。指定 default 即可清除任何最小執行個體設定。

或者，您也可以在部署期間使用以下指令，設定執行個體數量下限：

gcloud run deploy --image IMAGE_URL --min MIN-VALUE

取代

• IMAGE_URL 與容器映像檔的參照，例如 us-docker.pkg.dev/cloudrun/container/hello:latest。如果您使用的是 Artifact Registry，則必須先建立存放區 REPO_NAME。網址的形狀為 LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
• MIN-VALUE 可讓您指定要保持熱門的容器執行個體數量，以便接收要求。指定 default 可清除任何執行個體數量下限設定。

YAML

任何設定變更都會建立新的修訂版本。除非您明確做出更新，否則後續的修訂版本也會自動取得這個設定。

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

   gcloud run services describe SERVICE --format export > service.yaml

2. 更新 run.googleapis.com/minScale 屬性：

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: SERVICE
     annotations:
       run.googleapis.com/minScale: 'MIN_INSTANCE'

   取代：

   • SERVICE 改為 Cloud Run 服務名稱
   • MIN-INSTANCE 與要保留的例項數量，以便接收要求。

3. 使用下列指令建立或更新服務：

   gcloud run services replace service.yaml

用戶端程式庫

如要透過程式碼更新服務層級的最低執行個體數量，請按照下列步驟操作：

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• .NET

REST API

如要更新特定服務的服務層級最低執行個體，請將 PATCH HTTP 要求傳送至 Cloud Run Admin API service 端點。

例如使用 curl：

curl -H "Content-Type: application/json" \
-H "Authorization: Bearer ACCESS_TOKEN" \
-X PATCH \
-d '{ "scaling": { "minInstanceCount": MIN-VALUE }}' \
https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services/SERVICE?update_mask=scaling.minInstanceCount

取代：

• ACCESS_TOKEN 搭配有效的存取權杖，該帳戶具備更新服務的 IAM 權限。舉例來說，如果您登入 gcloud，可以使用 gcloud auth print-access-token 擷取存取權杖。您可以在 Cloud Run 容器執行個體中，使用容器執行個體中繼資料伺服器擷取存取權杖。
• MIN-VALUE 中指定要保持熱載的容器執行個體數量，以便接收要求。
• SERVICE 改為服務名稱。
• REGION 改為服務的 Google Cloud 區域。
• PROJECT-ID 與 Google Cloud 專案 ID。

控制台

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

   前往 Cloud Run

2. 按一下您感興趣的服務，開啟「服務詳細資料」面板。

3. 目前的設定會顯示在服務詳細資料面板的右上方，位於「Scaling」旁邊。

gcloud

1. 使用下列指令：

   gcloud run services describe SERVICE

2. 在傳回的設定中找出「Scaling: Auto (Min: MIN_VALUE, Max: MAX_VALUE)」的值。

控制台

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

   前往 Cloud Run

2. 從選單中選取「Services」(服務)，然後按一下「Deploy container」(部署容器)，即可設定新的服務。如果您要設定現有服務，請按一下該服務，然後點選「編輯並部署新修訂版本」。

3. 如果您要設定新服務，請填寫初始服務設定頁面，然後按一下「容器、磁碟區、網路與安全性」展開服務設定頁面。

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

   

   • 在標示為「執行個體數量下限」的欄位中，指定要保持暖機狀態的容器執行個體數量，以便接收要求。

5. 按一下 [Create] (建立) 或 [Deploy] (部署)。

gcloud

您可以使用下列指令更新特定服務的 min-instance：

gcloud run services update SERVICE --min-instances MIN-VALUE

取代：

• SERVICE 改為您的服務名稱。
• MIN-VALUE 可讓您指定要保留的容器執行個體數量，以便接收要求。指定 default 即可清除任何最小執行個體設定。

您也可以在部署期間使用以下指令設定 min-instance：

gcloud run deploy --image IMAGE_URL --min-instances MIN-VALUE

取代：

• IMAGE_URL 與容器映像檔的參照，例如 us-docker.pkg.dev/cloudrun/container/hello:latest。如果您使用的是 Artifact Registry，則必須先建立存放區 REPO_NAME。網址的形狀為 LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
• MIN-VALUE 可讓您指定要保留的容器執行個體數量，以便接收要求。指定 default 即可清除任何最小執行個體設定。

YAML

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

   gcloud run services describe SERVICE --format export > service.yaml

2. 更新 autoscaling.knative.dev/minScale: 屬性：

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: SERVICE
   spec:
     template:
       metadata:
         annotations:
           autoscaling.knative.dev/minScale: 'MIN-INSTANCE'
         name: REVISION

   取代：

   • SERVICE 改為 Cloud Run 服務名稱
   • MIN-INSTANCE 與要保留的例項數量，以便接收要求。
   • REVISION 並使用新的修訂版本名稱，或刪除該版本 (如有)。如果您提供新的修訂版本名稱，則該名稱必須符合下列條件：
     • 開頭為 SERVICE-
     • 只能包含小寫英文字母、數字和 -
     • 結尾不是 -
     • 長度不得超過 63 個半形字元

3. 使用下列指令建立或更新服務：

   gcloud run services replace service.yaml

Terraform

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

resource "google_cloud_run_v2_service" "default" {
  name     = "cloudrun-service-min-instances"
  location = "us-central1"

  deletion_protection = false # set to "true" in production

  template {
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello"
    }
    scaling {
      # Min instances
      min_instance_count = 1
    }
  }
}

上述 google_cloud_run_v2_service 資源會在 template.scaling 下指定 1 的執行個體數量下限。將 1 替換為您自己的執行個體數量下限。

主控台

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

   前往 Cloud Run

2. 按一下您感興趣的服務，開啟「服務詳細資料」面板。

3. 按一下「Revisions」(修訂版本) 分頁標籤。

4. 在右側的詳細資料面板中，「容器」分頁下方會列出「修訂版本最小例項」設定。

gcloud

1. 使用下列指令：

   gcloud run services describe SERVICE

2. 在傳回的設定中找出「Min instances:」的值。