配置容器

控制台

1. 在 Google Cloud 控制台中，前往 Cloud Run：

   转到 Cloud Run

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

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

4. 点击容器标签页。

   

   • 指定要向其发送请求的端口（如果该端口不是默认值 8080）。这也会设置 PORT 环境变量。

5. 点击创建或部署。

命令行

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

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。如果您使用 Artifact Registry，则必须预先创建制品库 REPO_NAME。网址的形状为 LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG。

YAML

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

   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。 如果您使用 Artifact Registry，则必须预先创建制品库 REPO_NAME。网址的形状为 LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
   • 将 PORT 替换为要向其发送请求的端口。
   • 将 REVISION 替换为新的修订版本名称或者将其删除（如果存在）。如果您提供新的修订版本名称，则该名称必须满足以下条件：
     • 开头为 SERVICE-
     • 仅包含小写字母、数字和 -
     • 不以 - 结尾
     • 不超过 63 个字符

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

   gcloud run services replace service.yaml

控制台

1. 在 Google Cloud 控制台中，前往 Cloud Run：

   转到 Cloud Run

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

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

4. 点击容器标签页。

   

   • 指定您希望容器运行的命令（如果该命令不是容器中定义的命令）；您还可以选择指定入口点命令的参数。

5. 点击创建或部署。

命令行

如需更新现有服务的启动命令和参数，请执行以下操作：

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。如果您使用 Artifact Registry，则必须预先创建制品库 REPO_NAME。网址的形状为 LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG

如需清除您设置的任何入口点命令和参数（恢复为容器默认值），请提供空字符串，如下所示：

gcloud run deploy --image IMAGE_URL --command "" --args ""

YAML

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

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

2. 更新 command 和 args 特性：

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

   替换

   • 将 IMAGE_URL 替换为对容器映像的引用，例如 us-docker.pkg.dev/cloudrun/container/hello:latest。 如果您使用 Artifact Registry，则必须预先创建制品库 REPO_NAME。网址的形状为 LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
   • 将 COMMAND 替换为启动容器的命令（如果您未使用默认命令）。
   • 将 ARG1 替换为要发送到容器命令的参数。如果您使用多个参数，在指定参数时应使每个参数独占一行，例如 ARG-N。

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

   gcloud run services replace service.yaml

Terraform

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

以下 google_cloud_run_v2_service 资源指定了命令和参数。将 /server 替换为用于启动容器的命令，并将任何必要的参数添加到 args 数组。

resource "google_cloud_run_v2_service" "default" {
  name     = "cloudrun-service-containers"
  location = "us-central1"

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

      # Container "entry-point" command
      command = ["/server"]

      # Container "entry-point" args
      args = []
    }
  }
}

控制台

1. 转到 Cloud Run

   • 对于现有服务，请点击列表中的服务，然后选择修改和部署新的修订版本以显示修订版本部署表单。
   • 对于新服务，请点击创建服务。

2. 对于新服务，请指定服务名称、Ingress 容器网址、CPU 分配、Ingress 控制和身份验证，然后点击容器、卷、网络、安全性。

3. 对于新服务，在容器、卷、网络、安全性标签页中，执行以下操作：

   1. 配置 Ingress 容器。
   2. 如需添加要部署的每个其他容器，请点击添加容器。
   3. 对于除 Ingress 容器之外的所有容器，请配置启动健康检查。Ingress 容器具有默认的启动健康检查。
   4. 如果某个容器需要先启动其他容器才能启动，请使用容器启动顺序菜单选择必须先启动的容器。

4. 对于现有服务，请按以下步骤操作：

   1. 对于除 Ingress 容器之外的所有容器，请配置启动健康检查。Ingress 容器具有默认的启动健康检查。
   2. 每个容器都有自己的容器启动顺序菜单。如果某个容器需要先启动其他容器才能启动，请使用容器启动顺序菜单选择必须先启动的容器。

5. 完成任何其他必需配置，然后点击创建（对于新服务）或部署（对于现有服务）。等待部署完成。

命令行

Google Cloud CLI 中的 container 参数为预览版。

在使用 Google Cloud CLI 指定启动顺序之前，您必须为除 Ingress 容器之外的所有容器配置启动健康检查。Ingress 容器具有默认的启动健康检查。您无法使用 Google Cloud CLI 来配置健康检查。

1. 在 Google Cloud 控制台中，激活 Cloud Shell。

   激活 Cloud Shell

   Cloud Shell 会话随即会在 Google Cloud 控制台的底部启动，并显示命令行提示符。Cloud Shell 是一个已安装 Google Cloud CLI 且已为当前项目设置值的 Shell 环境。该会话可能需要几秒钟时间来完成初始化。

2. 如需将多个容器部署到具有指定启动顺序的服务，请运行以下命令：

gcloud run deploy SERVICE \
     --container CONTAINER_1_NAME --image='INGRESS_IMAGE' \
     --container CONTAINER_2_NAME --image='SIDECAR_IMAGE' --depends-on=CONTAINER_1_NAME \
     --container CONTAINER_3_NAME --image='SIDECAR_IMAGE' --depends-on=CONTAINER_1_NAMECONTAINER_2_NAME

• 将 SERVICE 替换为要部署到的服务的名称。您可以完全省略此参数，但如果省略它，系统将提示您输入服务名称。
• 将 INGRESS_IMAGE 替换为对应接收请求的容器映像的引用，例如 us-docker.pkg.dev/cloudrun/container/hello:latest。

• 将 SIDECAR_IMAGE 替换为对 Sidecar 容器映像的引用

  如果要在部署命令中配置每个容器，请在 container 参数后面提供每个容器的配置。

YAML

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

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

2. 更新 container-dependencies 特性：

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     annotations:
     name: SERVICE
   spec:
     template:
       metadata:
         annotations:
           run.googleapis.com/container-dependencies: '{"CONTAINER1":["CONTAINER2"], "CONTAINER3":["CONTAINER1","CONTAINER2"]}'
   

   替换

   • 将 CONTAINER1 替换为依赖于一个或多个容器的第一个容器的名称。请注意，您可以在 YAML 中设置容器名称：如果未指定名称，Cloud Run 会自动生成一个名称。
   • 将 CONTAINER2 替换为必须在 CONTAINER1 之前启动的容器的名称。
   • 将 CONTAINER3 替换为依赖于一个或多个容器的第二个容器的名称。

   在 YAML 代码段中显示的示例中，CONTAINER2 先启动，CONTAINER1 然后启动，CONTAINER3 最后启动。

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

   gcloud run services replace service.yaml

控制台

1. 在 Google Cloud 控制台中，前往 Cloud Run：

   转到 Cloud Run

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

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

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

命令行

1. 使用以下命令：

   gcloud run services describe SERVICE

2. 在返回的配置中找到容器设置。