选择执行环境(服务)

本页面介绍如何为每个 Cloud Run 实例指定执行环境。对于 Cloud Run 服务,Cloud Run 实例默认在第一代执行环境中运行。您可以根据需要更改此设置,仅适用于服务。请注意,Cloud Run 作业会自动使用第二代执行环境,并且无法更改作业。

请参阅执行环境概念文档,帮助您选择最适合自己服务的环境。

设置和更新执行环境

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

默认情况下,对于 Cloud Run 服务,每个实例都使用第一代执行环境。如果您使用第二代,则还必须指定至少 512 MiB 的内存

您可以在创建新服务部署新修订版本 时使用 Google Cloud 控制台、gcloud 命令行或 YAML 文件来设置执行环境:

控制台

  1. 在 Google Cloud 控制台中,前往 Cloud Run:

    转到 Cloud Run

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

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

  4. 点击容器标签页。

    映像

    • 使用选项按钮选择所需的执行环境。
  5. 点击创建部署

命令行

您可以使用以下命令更新给定服务的执行环境

gcloud run services update SERVICE --execution-environment ENVIRONMENT

SERVICE 替换为您的服务名称,将 ENVIRONMENT 替换为所需的执行环境。为第一代执行环境指定值 gen1,或为第二代执行环境指定 gen2

您还可以在部署期间使用以下命令设置执行环境:

gcloud run deploy --image IMAGE_URL --execution-environment ENVIRONMENT

替换

  • IMAGE_URL 替换为对容器映像的引用,例如 us-docker.pkg.dev/cloudrun/container/hello:latest。 如果您使用 Artifact Registry,则必须已经创建制品库 REPO_NAME。网址格式为 REGION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
  • ENVIRONMENT 替换为所需的执行环境。为第一代执行环境指定值 gen1,或为第二代执行环境指定 gen2

YAML

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

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

    gcloud run services describe SERVICE --format export > service.yaml
  2. 设置 run.googleapis.com/execution-environment 注释:

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
      name: SERVICE
    spec:
      template:
        metadata:
          annotations:
            run.googleapis.com/execution-environment: ENVIRONMENT
          name: REVISION

    替换

    • SERVICE 替换为您的 Cloud Run 服务的名称
    • ENVIRONMENT 替换为所需的执行环境。为第一代执行环境指定值 gen1,或为第二代执行环境指定 gen2
    • REVISION 替换为新的修订版本名称或者将其删除(如果存在)。如果您提供新的修订版本名称,则该名称必须满足以下条件:
      • 开头为 SERVICE-
      • 仅包含小写字母、数字和 -
      • 不以 - 结尾
      • 不超过 63 个字符
  3. 使用以下命令将服务替换为其新配置:

    gcloud run services replace service.yaml

查看执行环境设置

要查看 Cloud Run 服务的当前执行环境设置,请执行以下操作:

控制台

  1. 在 Google Cloud 控制台中,前往 Cloud Run:

    转到 Cloud Run

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

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

  4. 在右侧的详细信息面板中,执行环境设置列在容器标签页下。

命令行

  1. 使用以下命令:

    gcloud run services describe SERVICE
  2. 在返回的配置中找到执行环境设置。