配置容器

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

本页面介绍如何为 Cloud Run 服务配置容器端口、入口点命令和参数,以及如何为 Cloud Run 作业配置入口点命令和参数。

当 Cloud Run 启动容器时,它会运行映像的默认入口点命令和默认命令参数。如果要替换映像的默认入口点和命令参数,您可以使用容器配置中的 commandargs 字段。command 字段指定容器运行的实际命令。args 字段指定传递给该命令的参数。

配置容器端口(服务)

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

对于 Cloud Run 服务,Cloud Run 会将 PORT 环境变量注入容器中。容器应侦听 PORT 环境变量定义的端口,而不是特定的硬编码端口。但是,如果无法做到这一点,您可以配置请求通过哪个端口发送到容器:请注意,端口设置不适用于 Cloud Run 作业。

控制台

  1. 转到 Cloud Run

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

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

  4. 点击容器标签页。

    图片

  5. 指定要向其发送请求的端口(如果该端口不是默认值“8080”)。这也会设置“PORT”环境变量。

  6. 点击创建部署

命令行

您可以使用以下命令更新服务的端口配置

gcloud run services update SERVICE --port PORT

替换

  • SERVICE 替换为相应服务的名称。
  • PORT 替换为要向其发送请求的端口。请注意,默认端口为 8080

您还可以使用以下命令在部署期间配置端口:

gcloud run deploy --image IMAGE_URL --port PORT

IMAGE_URL 替换为对容器映像的引用,例如 us-docker.pkg.dev/cloudrun/container/hello:latest

YAML

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

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

    gcloud run services describe SERVICE --format export > service.yaml
  2. 更新 containerPort: 特性:

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
      name: SERVICE
    spec:
      template:
        metadata:
          name: REVISION
        spec:
          containers:
          - image: IMAGE_URL
            ports:
            - containerPort: PORT
    

    替换

    • SERVICE 替换为您的 Cloud Run 服务的名称
    • IMAGE_URL 替换为对容器映像的引用(例如 us-docker.pkg.dev/cloudrun/container/hello:latest)。
    • PORT 替换为要向其发送请求的端口。
    • REVISION 替换为新的修订版本名称或者将其删除(如果存在)。如果您提供新的修订版本名称,则该名称必须满足以下条件:
      • 开头为 SERVICE-
      • 仅包含小写字母、数字和 -
      • 不以 - 结尾
      • 不超过 63 个字符
  3. 使用以下命令将服务替换为其新配置:

    gcloud run services replace service.yaml

配置容器入口点命令和参数

您可以为 Cloud Run 作业和服务配置入口点命令和参数。

对于 Cloud Run 服务

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

指定的容器命令和参数会替换默认映像 ENTRYPOINTCMD

您可以在创建新服务部署新修订版本时使用 Google Cloud 控制台、gcloud 命令行或使用 .yaml 文件来设置入口点命令和参数:

控制台

  1. 转到 Cloud Run

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

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

  4. 点击容器标签页。

    图片

  5. 指定您希望容器运行的命令(如果该命令不是容器中定义的命令);您还可以选择指定入口点命令的参数。

  6. 点击创建部署

命令行

您可以使用以下命令更新给定服务的启动命令和参数

gcloud run services update SERVICE --command COMMAND --args ARG1,ARG-N

替换

  • COMMAND 替换为启动容器的命令(如果您未使用默认命令)。
  • ARG1 替换为要发送到容器命令的参数;请对多个参数使用英文逗号分隔列表。

您还可以使用以下命令在部署期间指定入口点和参数:

gcloud run deploy --image IMAGE_URL --command COMMAND --args ARG1,ARG-N

IMAGE_URL 替换为对容器映像的引用,例如 us-docker.pkg.dev/cloudrun/container/hello:latest

YAML

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

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

    gcloud run services describe SERVICE --format export > service.yaml
  2. 更新 commandargs 特性:

    spec:
      containers:
      - image: IMAGE_URL
        command:
        - COMMAND
        args:
        - "ARG1"
        - "ARG-N"
    

    替换

    • IMAGE_URL 替换为对容器映像的引用(例如 us-docker.pkg.dev/cloudrun/container/hello:latest)。
    • COMMAND 替换为启动容器的命令(如果您未使用默认命令)。
    • ARG1 替换为要发送到容器命令的参数;请对多个参数使用英文逗号分隔列表。
  3. 使用以下命令将服务替换为其新配置:

    gcloud run services replace service.yaml

Terraform

将以下代码添加到 Terraform 配置中的 google_cloud_run_service 资源中。将 /server 替换为用于启动容器的命令,并将任何必要的参数添加到 args 数组。

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

      # Container "entry-point" command
      # https://cloud.google.com/run/docs/configuring/containers#configure-entrypoint
      command = ["/server"]

      # Container "entry-point" args
      # https://cloud.google.com/run/docs/configuring/containers#configure-entrypoint
      args = []
    }
  }

如需在 Google Cloud 项目中应用 Terraform 配置,请完成以下步骤:

  1. 启动 Cloud Shell
  2. 设置要应用 Terraform 配置的 Google Cloud 项目:
    export GOOGLE_CLOUD_PROJECT=PROJECT_ID
    
  3. 创建一个目录,并在该目录中打开一个新文件。文件名必须具有 .tf 扩展名,例如 main.tf
    mkdir DIRECTORY && cd DIRECTORY && nano main.tf
    
  4. 将示例复制到 main.tf
  5. 查看和修改要应用到您的环境的示例参数。
  6. 依次按 Ctrl-xy 保存更改。
  7. 初始化 Terraform:
    terraform init
  8. 查看配置并验证 Terraform 将创建或更新的资源是否符合您的预期:
    terraform plan

    根据需要更正配置。

  9. 通过运行以下命令并在提示符处输入 yes 来应用 Terraform 配置:
    terraform apply

    等待 Terraform 显示“应用完成!”消息。

  10. 打开您的 Google Cloud 项目以查看结果。在 Google Cloud 控制台中,在界面中找到资源,以确保 Terraform 已创建或更新它们。

对于 Cloud Run 作业

如需配置作业的命令入口点和参数,请执行以下操作:

控制台

  1. 转到 Cloud Run

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

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

  4. 点击常规标签页。

    映像

  5. 指定您希望容器运行的命令(如果该命令不是容器中定义的命令);您还可以选择指定入口点命令的参数。

  6. 点击创建更新

命令行

  1. 为新作业设置启动命令和参数

    gcloud beta run jobs create JOB_NAME --image IMAGE_URL --command COMMAND --args ARG1,ARG-N

    替换

    • JOB_NAME 替换为作业的名称。
    • COMMAND 替换为启动容器的命令(如果您未使用默认命令)。
    • ARG1 替换为要发送到容器命令的参数,或者对多个参数使用英文逗号分隔列表。
    • IMAGE_URL 替换为对容器映像的引用,例如 us-docker.pkg.dev/cloudrun/container/job:latest
  2. 为现有作业更新命令和参数:

    gcloud beta run jobs update JOB_NAME --command COMMAND --args ARG1,ARG-N 

在参数中使用等号或英文逗号

如果您在参数中使用等号,请使用以下格式提供这些参数:

gcloud run deploy  \
  --args="--repo-allowlist=github.com/example/example_demo" \
  --args="--gh-webhook-secret=XX" \

如果参数使用英文逗号,请参阅配置环境变量以详细了解如何进行转义。

查看容器设置

如需查看 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 beta run jobs describe JOB_NAME
  2. 在返回的配置中找到容器设置。