配置 CPU 限制

本页介绍如何指定每个 Cloud Run 实例所使用的 CPU 数量。默认情况下，系统会将 Cloud Run 容器实例限制为 1 个 CPU。您可以按照本页中的说明增加或减少此值。

本页面还介绍了如何启用或停用启动 CPU 加速功能，该功能可在实例启动期间临时增加 CPU 分配，以缩短启动延迟时间。

设置和更新 CPU 限制

默认情况下，系统会将每个实例限制为 1 个 CPU。您可以使用任何整数值增加此值，但不能超过 8 个 CPU。

CPU 和内存

以下是 CPU 的最低内存要求：

CPU	最小内存
4	2 GiB
6	4 GiB
8	4 GiB

或者，如果您想要使用的 CPU 少于 1 个，则可以选择 0.08 到 1 之间的任何值，以 0.01 为增量。任何大于 1 的值都必须是整数值。如果您使用的 CPU 少于 1 个，则必须符合以下要求：

设置	要求
内存	如需设置大于 512MiB 的内存限制，至少需要 0.5 个 CPU。如需设置大于 1GiB 的内存限制，至少需要 1 个 CPU。
并发	最大并发必须设置为 `1`。
分配的 CPU	CPU 分配必须设置为仅在请求处理期间才分配 CPU。
执行环境	您必须使用第一代执行环境。

所需的角色

如需获得配置和部署 Cloud Run 服务所需的权限，请让管理员向您授予以下 IAM 角色：

Cloud Run 服务的 Cloud Run Developer (roles/run.developer) 角色
服务身份的 Service Account User (roles/iam.serviceAccountUser) 角色

如需查看与 Cloud Run 关联的 IAM 角色和权限的列表，请参阅 Cloud Run IAM 角色和 Cloud Run IAM 权限。如果您的 Cloud Run 服务与 Google Cloud API（例如 Cloud 客户端库）进行交互，请参阅服务身份配置指南。如需详细了解如何授予角色，请参阅部署权限和管理访问权限。

配置 CPU 限制

任何配置更改都会导致新修订版本的创建。后续修订版本也将自动采用此配置设置，除非您进行了明确更新。

您可以在创建新服务或部署新修订版本时使用 Google Cloud 控制台、gcloud 命令行或 YAML 文件设置 CPU 限额：

控制台

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

转到 Cloud Run
如果您是要配置一个新服务来作为部署目标，请点击创建服务。如果您要配置现有服务，请点击该服务，然后点击修改和部署新的修订版本。
如果您要配置新服务，请根据需要填写初始服务设置页面，然后点击容器、网络、安全性以展开服务配置页面。
点击容器标签页。
- 从下拉列表中选择所需的 CPU 限制，如果您想要使用少于 1 个 CPU，请使用自定义。选择 1、2、4、6 或 8 个 CPU，或者如果少于 1 个 CPU，请指定 0.08 到 1.00 之间的值（以 0.01 为增量）。（如需了解所需设置，请参阅设置和更新 CPU 限制下的表。）
点击创建或部署。

命令行

对于给定的服务，您可以使用以下命令来更新 CPU 限制：

gcloud run services update SERVICE --cpu CPU

替换

将 SERVICE 替换为服务的名称
将 CPU 替换为所需的 CPU 限制。指定 1、2、4、6 或 8 个 CPU，或者如果少于 1 个 CPU，请指定 0.08 到 1.00 之间的值（以 0.01 为增量）。（如需了解所需设置，请参阅设置和更新 CPU 限制下的表。）

您还可以在部署期间使用以下命令设置 CPU：

gcloud run deploy --image IMAGE_URL --cpu CPU

替换

将 IMAGE_URL 替换为对容器映像的引用，例如 us-docker.pkg.dev/cloudrun/container/hello:latest。如果您使用 Artifact Registry，则必须预先创建制品库 REPO_NAME。网址的形状为 LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG。
将 CPU 替换为 1、2、4、6 或 8 个 CPU；如果少于 1 个 CPU，请指定 0.08 到 1.00 之间的值（以 0.01 为增量）。（如需了解所需设置，请参阅设置和更新 CPU 限制下的表。）

YAML

如果您要创建新的服务，请跳过此步骤。如果您要更新现有服务，请下载其 YAML 配置：
```
gcloud run services describe SERVICE --format export > service.yaml
```
更新 cpu 特性：
```
apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: SERVICE
spec:
  template:
    metadata:
      name: REVISION
    spec:
      containers:
      - image: IMAGE
        resources:
          limits:
            cpu: CPU
```
替换
- 将 SERVICE 替换为您的 Cloud Run 服务的名称
- 将 IMAGE_URL 替换为对容器映像的引用，例如 us-docker.pkg.dev/cloudrun/container/hello:latest。如果您使用 Artifact Registry，则必须预先创建制品库 REPO_NAME。网址的形状为 LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
- 将 CPU 替换为所需的 CPU 限制值。指定 1、2、4、6 或 8 个 CPU，或者如果少于 1 个 CPU，请指定 0.08 到 1.00 之间的值（以 0.01 为增量）。（如需了解所需设置，请参阅设置和更新 CPU 限制下的表。）
- 将 REVISION 替换为新的修订版本名称或者将其删除（如果存在）。如果您提供新的修订版本名称，则该名称必须满足以下条件：
  - 开头为 SERVICE-
  - 仅包含小写字母、数字和 -
  - 不以 - 结尾
  - 不超过 63 个字符
使用以下命令创建或更新服务：
```
gcloud run services replace service.yaml
```

Terraform

如需了解如何应用或移除 Terraform 配置，请参阅基本 Terraform 命令。

以下 google_cloud_run_v2_service 资源在 template.containers.resources.limits 下指定了 CPU 限制。将 1 替换为所需的 CPU 数量。

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

  template {
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello"
      resources {
        limits = {
          # CPU usage limit
          cpu = "1"
        }
      }
    }
  }
}

设置启动 CPU 加速

修订版本的启动 CPU 加速功能可在实例启动时间内以及实例启动后 10 秒内提供额外的 CPU。

实际 CPU 加速情况因 CPU 限制设置而异：

CPU 上限	加速 CPU
0-1	2
2	4
4	8
6	8
8	8

在容器启动期间，您需要为分配的加速 CPU 付费。例如，如果您的容器启动时间为 15 秒，并且分配了 2 个 CPU，同时启用了启动 CPU 加速功能，则您需要在实例启动期间内（可能更短），包括容器完成启动后的 10 秒内支付 4 个 CPU 的费用，并且需要在容器剩余生命周期内支付 2 个 CPU 的费用。

您可以使用 Google Cloud 控制台或 Google Cloud CLI 启用或停用启动 CPU 加速。

控制台

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

转到 Cloud Run
如果您是要配置一个新服务来作为部署目标，请点击创建服务。如果您要配置现有服务，请点击该服务，然后点击修改和部署新的修订版本。
如果您要配置新服务，请根据需要填写初始服务设置页面，然后点击容器、网络、安全性以展开服务配置页面。
点击容器标签页。
- 如需启用启动 CPU 加速，请选中“启动 CPU 加速”复选框。如需停用此功能，请取消选择该复选框。
点击创建或部署。

命令行

您可以使用以下命令为给定服务启用启动 CPU 加速：
```
gcloud run services update SERVICE --cpu-boost
```
将 SERVICE 替换为服务的名称

您可以使用以下命令在部署期间启用启动 CPU 加速：
```
gcloud run deploy --image IMAGE_URL --cpu-boost
```
将 IMAGE_URL 替换为对容器映像的引用，例如 us-docker.pkg.dev/cloudrun/container/hello:latest。如果您使用 Artifact Registry，则必须预先创建制品库 REPO_NAME。网址的形状为 LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG。
您可以使用以下命令为给定服务停用启动 CPU 加速：
```
gcloud run services update SERVICE --no-cpu-boost
```
将 SERVICE 替换为服务的名称

您可以使用以下命令在部署期间停用启动 CPU 加速：
```
gcloud run deploy --image IMAGE_URL --no-cpu-boost
```

YAML

如果您要创建新的服务，请跳过此步骤。如果您要更新现有服务，请下载其 YAML 配置：
```
gcloud run services describe SERVICE --format export > service.yaml
```

更新 run.googleapis.com/startup-cpu-boost 特性：指定 'true' 以启用启动 CPU 加速，或指定 'false' 以停用：

apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: SERVICE
spec:
  template:
    metadata:
      annotations:
        run.googleapis.com/startup-cpu-boost: 'true'

替换

将 SERVICE 替换为您的 Cloud Run 服务的名称

使用以下命令创建或更新服务：
```
gcloud run services replace service.yaml
```

查看 CPU 设置

如需查看 Cloud Run 服务的当前 CPU 设置，请按照以下所述操作：

控制台

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

转到 Cloud Run
点击您感兴趣的服务以打开“服务详细信息”页面。
点击修订版本标签页。
在右侧的详细信息面板中，“容器”标签页下列出了 CPU 设置。

命令行

使用以下命令：
```
gcloud run services describe SERVICE
```
在返回的配置中找到 CPU 设置。