配置内存限制

本页面介绍如何设置内存限制。

了解内存用量

如果 Cloud Run 实例超出其允许的内存限制，则该应用会被终止。

以下各项会计入实例的可用内存：

  • 运行应用可执行文件（当可执行文件必须加载到内存中时）
  • 在应用进程中分配内存
  • 将文件写入文件系统

部署的容器映像的大小不会计入可用内存。

设置和更新内存限制

您可以为 Cloud Run 服务和作业设置内存限制。默认情况下，系统会为修订版本或作业的每个实例分配 512 MiB 内存。

要求的最小 CPU 数

设置内存限制时，需要满足以下最小 CPU 数限制：

内存 所需的最少 CPU 数
超过 4 GiB 2
超过 8 GiB 4
超过 16 GiB 6
超过 24 GiB 8

最大内存量

您最多可以配置 32 吉比字节 (32 Gi) 内存。

最小内存

最小内存设置取决于您使用第一代还是第二代执行环境：

  • 128 MiB（第一代）
  • 512 MiB（第二代）

对于 Cloud Run 服务

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

对于 Cloud Run 服务，您可以在创建新服务或部署新的修订版本时使用 Google Cloud 控制台、gcloud 命令行或 YAML 文件来设置内存限制：

控制台

  1. 转到 Cloud Run

  2. 如果您是要配置一个新服务来作为部署目标，请点击创建服务。如果您要配置现有服务，请点击该服务，然后点击修改和部署新的修订版本。

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

  4. 点击容器标签页。

    图片

    • 从内存下拉列表中选择所需的内存大小。

  5. 点击创建或部署。

命令行

您可以使用以下命令更新给定服务的内存分配：

gcloud run services update SERVICE --memory SIZE

将 SERVICE 替换为您的服务名称，并将 SIZE 替换为所需的内存大小。内存大小的格式为定点数或浮点数，后接单位G 或 M（分别表示千兆字节或兆字节），也可以使用等效的 2 的幂次方数，后接单位 Gi 或 Mi（分别表示吉比字节或兆比字节）。

您还可以在部署期间使用以下命令设置内存限制：

gcloud run deploy --image IMAGE_URL --memory SIZE

替换

  • 将 IMAGE_URL 替换为对容器映像的引用，例如 us-docker.pkg.dev/cloudrun/container/hello:latest。 使用 Artifact Registry 时，网址的格式为 REGION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG。。
  • 将 SIZE 替换为适当值（见上文）。

YAML

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

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

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

  2. 更新 memory 特性：

    apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: SERVICE
spec:
  template:
    metadata:
      name: REVISION
    spec:
      containers:
      - image: IMAGE
        resources:
          limits:
            memory: SIZE

    替换

    • 将 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。
    • 将 SIZE 替换为所需的内存大小。格式为定点数或浮点数，后接单位 G 或 M（分别表示千兆字节或兆字节），也可以使用 2 的幂次方数，后接单位 Gi 或 Mi（分布表示吉比字节或兆比字节分）。
    • 将 REVISION 替换为新的修订版本名称或者将其删除（如果存在）。如果您提供新的修订版本名称，则该名称必须满足以下条件：
      • 开头为 SERVICE-
      • 仅包含小写字母、数字和 -
      • 不以 - 结尾
      • 不超过 63 个字符

  3. 使用以下命令将服务替换为其新配置：

    gcloud run services replace service.yaml

Terraform

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

将以下内容添加到 Terraform 配置中的 template.spec.containers.resources.limits 下的 google_cloud_run_service 资源中。将 512Mi 替换为服务所需的内存限制。

run/cloud_run_configuration_memory_limits/main.tf 
resource "google_cloud_run_service" "default" {
  name     = "cloudrun-service-memory-limits"
  location = "us-central1"

  template {
    spec {
      containers {
        image = "us-docker.pkg.dev/cloudrun/container/hello"

        resources {
          limits = {
            # Memory usage limit (per container)
            # https://cloud.google.com/run/docs/configuring/memory-limits
            memory = "512Mi"
          }
        }
      }
    }
  }
  lifecycle {
    ignore_changes = [
      template[0].spec[0].containers[0].resources[0].limits,
    ]
  }
}

对于 Cloud Run 作业

对于 Cloud Run 作业，您必须至少指定 512Mi。如需为 Cloud Run 作业指定内存，请执行以下操作：

控制台

  1. 转到 Cloud Run

  2. 如果要配置新作业，请点击作业标签页，然后根据需要填写初始作业设置页面。如果要配置现有作业，请点击作业，然后点击修改。

  3. 点击容器、变量和 Secret、连接、安全性以展开作业属性页面。

  4. 点击容器标签页。

    图片

    • 从内存下拉列表中选择所需的内存大小。

  5. 点击创建或更新。

命令行

  1. 如需在创建作业时设置内存限制，请运行以下命令：

    gcloud run jobs create JOB_NAME --image IMAGE_URL --memory SIZE

    替换

    • 将 JOB_NAME 替换为作业的名称。
    • 将 IMAGE_URL 替换为对容器映像的引用，例如 us-docker.pkg.dev/cloudrun/container/job:latest。
    • 将 SIZE 替换为所需的内存大小。 内存大小的格式为定点数或浮点数，后接单位 G 或 M（分别对应于千兆字节或兆字节），也可以使用等效的 2 的幂次方数，后接单位 Gi 或 Mi（分别对应于吉比字节或兆比字节）。

  2. 如需在更新作业时设置内存限制，请运行以下命令：

    gcloud run jobs update JOB_NAME --memory SIZE

YAML

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

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

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

  2. 更新 memory 特性：

    apiVersion: run.googleapis.com/v1
kind: Job
metadata:
  name: JOB
spec:
  template:
    spec:
      template:
        spec:
      containers:
      - image: IMAGE
        resources:
          limits:
            memory: SIZE

    将 SIZE 替换为所需的内存大小，指定至少 512MiB。格式为定点数或浮点数，后接单位 G 或 M（分别表示千兆字节或兆字节），也可以使用 2 的幂次方数，后接单位 Gi 或 Mi（分布表示吉比字节或兆比字节分）。

    您还可以指定更多配置，例如环境变量或内存限制。

  3. 更新现有作业配置：

    gcloud run jobs replace job.yaml

优化服务的内存

对于 Cloud Run 服务，您可以通过以下方式确定服务所需的最高内存：（常规内存）+（每个请求所需的内存）*（服务并发请求数）

由此可见：

  • 如果提高服务的并发请求数，则还应增加内存限制，以应对使用高峰。

  • 如果降低服务的并发请求数，则应考虑减小内存限制，以节省内存使用费用。

如需详细了解如何最大限度地降低每个请求的内存用量，请参阅关于全局变量的开发提示。

查看内存限制设置

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

控制台

  1. 转到 Cloud Run

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

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

  4. 在右侧的详细信息面板中，“容器”标签页下列出了内存限制设置。

命令行

  1. 使用以下命令：

    gcloud run services describe SERVICE

  2. 在返回的配置中找到内存限制设置。

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

控制台

  1. 转到 Cloud Run 作业

  2. 点击相关作业以打开作业详情页面。

  3. 点击配置标签页。

  4. 在配置详细信息中找到内存限制设置。

命令行

  1. 使用以下命令：

    gcloud run jobs describe JOB_NAME

  2. 在返回的配置中找到内存限制设置。