设置实例数下限（服务）

控制台

1. 在 Google Cloud 控制台中，前往 Cloud Run：

   转到 Cloud Run

2. 如果您要配置新服务，请点击部署容器，然后选择服务以显示创建服务表单。如果您要配置现有服务，请点击该服务以显示其详细信息面板，然后点击详细信息面板右上角的实例数下限旁边的笔图标。

3. 找到服务自动扩缩表单。

   

   • 在标为实例数下限字段中，指定要保持备用状态以准备接收请求的容器实例数量。

4. 点击创建（对于新服务）或部署（对于现有服务）。

gcloud

使用以下命令为给定服务更新 service-min-instances：

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

您需要进行如下替换：

• 将 SERVICE 替换为您的服务名称。
• 将 MIN-VALUE 替换为要保持备用状态以准备接收请求的容器实例数量。指定 default 即可清除任何实例数下限设置。

或者，您可以在部署期间使用以下命令设置 service-min-instances：

gcloud run deploy --image IMAGE_URL --service-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. 更新 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

如果更新给定服务的服务级实例数下限，请向 Cloud Run Admin API service 端点发送 PATCH HTTP 请求。

例如，使用 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. 当前设置会显示在“服务详细信息”面板右上角的实例数下限旁边。

gcloud

1. 使用以下命令：

   gcloud run services describe SERVICE

2. 在返回的配置中找到服务级实例数下限：的值。

控制台

1. 在 Google Cloud 控制台中，前往 Cloud Run：

   转到 Cloud Run

2. 点击部署容器，然后选择服务以配置新服务。如果您要配置现有服务，请点击该服务，然后点击修改和部署新的修订版本。

3. 如果您要配置新服务，请根据需要填写初始服务设置页面，然后点击容器、网络、安全性以展开服务配置页面。

4. 点击容器标签页。

   

   • 在“实例数下限”字段中，指定要保持备用状态以准备接收请求的容器实例数量。

5. 点击创建或部署。

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 命令。

以下 google_cloud_run_v2_service 资源在 template.scaling 下指定了 1 的实例数下限。将 1 替换为您自己的实例数下限。

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

控制台

1. 在 Google Cloud 控制台中，前往 Cloud Run：

   转到 Cloud Run

2. 点击您感兴趣的服务以打开“服务详细信息”页面。

3. 点击修订版本标签页。

4. 在右侧的详细信息面板中，“容器”标签页下列出了修订版本级实例数下限设置。

gcloud

1. 使用以下命令：

   gcloud run services describe SERVICE

2. 在返回的配置中找到修订版本级实例数下限设置。