选择执行环境(服务)

本页面介绍了如何指定 Cloud Run 实例的执行环境。默认情况下,Cloud Run 服务未指定执行环境,这意味着 Cloud Run 会根据使用的功能选择执行环境。如果您没有为服务指定执行环境,则 Cloud Run 可以选择第一代或第二代环境。

请注意,Cloud Run 作业会使用第二代执行环境,并且无法对作业进行更改。

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

所需的角色

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

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

设置和更新执行环境

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

Cloud Run 服务的默认值未指定,这意味着 Cloud Run 会选择合适的执行环境。或者,您也可以指定执行环境。如需使用第二代执行环境,您必须指定至少 512 MiB 的内存

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

控制台

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

    转到 Cloud Run

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

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

  4. 点击容器标签页。

    图片

    • 使用选项按钮选择所需的执行环境。 保留“默认”可让 Cloud Run 选择合适的执行环境。
  5. 点击创建部署

gcloud

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

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。网址格式为 LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
  • ENVIRONMENT 替换为所需的执行环境。为第一代执行环境指定值 gen1,或为第二代执行环境指定 gen2

YAML

  1. 如果您要创建新的服务,请跳过此步骤。如果您要更新现有服务,请下载其 YAML 配置

    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

    替换

    • SERVICE 替换为您的 Cloud Run 服务的名称
    • ENVIRONMENT 替换为选定的执行环境。 为第一代执行环境指定值 gen1,或为第二代执行环境指定 gen2

    移除默认行为的 run.googleapis.com/execution-environment 注解。

  3. 使用以下命令创建或更新服务:

    gcloud run services replace service.yaml

查看执行环境设置

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

控制台

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

    转到 Cloud Run

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

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

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

gcloud

  1. 使用以下命令:

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