CPU 上限

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

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

设置和更新 CPU 限制

您可以为 Cloud Run 服务和作业设置 CPU 限制。

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

CPU 和内存

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

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

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

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

对于 Cloud Run 服务

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

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

控制台

转到 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 时，网址的格式为 REGION-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

您可以使用 gcloud run services describe --format export 命令下载并查看现有服务配置，该命令会生成清理后的 YAML 格式的结果。然后按照后续说明修改字段，最后使用 gcloud run services replace 命令上传修改后的 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 时，网址的格式为 REGION-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_service 资源在 template.spec.containers.resources.limits 下指定了 CPU 限制。将 1000m 替换为所需的 CPU 数量。

run/cloud_run_configuration_cpu/main.tf

在 GitHub 上查看反馈

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

  template {
    spec {
      containers {
        image = "us-docker.pkg.dev/cloudrun/container/hello"
        resources {
          limits = {
            # CPU usage limit
            # https://cloud.google.com/run/docs/configuring/cpu
            cpu = "1000m" # 1 vCPU
          }
        }
      }
    }
  }
  lifecycle {
    ignore_changes = [
      template[0].spec[0].containers[0].resources[0].limits,
    ]
  }
}

对于 Cloud Run 作业

对于 Cloud Run 作业，您必须至少设置 1 个 CPU。

如需为 Cloud Run 作业指定 CPU，请执行以下操作：

控制台

转到 Cloud Run
如果要配置新作业，请点击作业标签页，然后根据需要填写初始作业设置页面。如果要配置现有作业，请点击作业，然后点击修改。
点击容器、变量和 Secret、连接、安全性以展开作业属性页面。
点击常规标签页。
- 从下拉列表中选择所需的 CPU 限制。选择 1、2、4、6 或 8 个 CPU。作业至少需要 1 个 CPU。（如需了解所需设置，请参阅设置和更新 CPU 限制下的表。）
点击创建或更新。

命令行

使用以下命令更新给定作业的 CPU 限制：
```
gcloud run jobs update JOB_NAME --cpu CPU
```
替换
- 将 JOB_NAME 替换为作业的名称
- 将 CPU 替换为所需的 CPU 限制。指定 1、2、4、6 或 8 个 CPU。作业至少需要 1 个 CPU。（如需了解所需设置，请参阅设置和更新 CPU 限制下的表。）
您也可以在使用以下命令创建作业时设置 CPU：
```
gcloud run jobs create JOB_NAME --image IMAGE_URL --cpu CPU
```
替换
- 将 JOB_NAME 替换为作业的名称。
- 将 IMAGE_URL 替换为对容器映像的引用，例如 us-docker.pkg.dev/cloudrun/container/job:latest。
- 将 CPU 替换为所需的 CPU 限制。指定 1、2、4、6 或 8 个 CPU。作业至少需要 1 个 CPU。（如需了解所需设置，请参阅设置和更新 CPU 限制下的表。）

YAML

使用 gcloud run jobs describe --format export 命令下载并查看现有作业配置，该命令会生成清理后的 YAML 格式的结果。然后，修改下述字段，并使用 gcloud run jobs replace 命令上传修改后的 YAML。请务必严格按照说明修改字段。

要查看和下载配置，请运行以下命令：

gcloud run jobs describe JOB_NAME --format export > job.yaml

更新 cpu 特性：
```
apiVersion: run.googleapis.com/v1
kind: Job
metadata:
  name: JOB
spec:
  template:
    spec:
      template:
        spec:
          containers:
          - image: IMAGE
          resources:
            limits:
              cpu: CPU
```
将 CPU 替换为所需的 CPU 限制。指定 1、2、4、6 或 8 个 CPU。作业至少需要 1 个 CPU。（如需了解所需设置，请参阅设置和更新 CPU 限制下的表。）

您还可以指定更多配置，例如环境变量或内存限制。
更新现有作业配置：
```
gcloud run jobs replace job.yaml
```

设置启动 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 加速。

控制台

转到 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 时，网址的格式为 REGION-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

如需查看和下载配置，请运行以下命令：

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 设置，请按照以下所述操作：

控制台

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

命令行

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

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

控制台

转到 Cloud Run 作业
点击相关作业以打开作业详情页面。
点击配置标签页。
在配置详细信息中找到 CPU 设置。

命令行

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