部署到 Cloud Run

控制台

要部署容器映像，请执行以下操作：

1. 转到 Cloud Run

2. 点击创建服务，以显示“创建服务”表单。

   1. 在该表单中选择部署选项：

      1. 如果您要手动部署容器，请选择从现有容器映像部署一个修订版本并指定容器映像。

      2. 如果要自动进行持续部署，请选择“从源代码库中持续部署新修订版本”并按照持续部署的说明进行操作。

   2. 输入所需的服务名称。服务名称不得超过 49 个字符，并且在每个区域和项目中必须是唯一的。服务名称一旦指定便无法更改，并且公开显示。

   3. 选择您想要使用的服务区域。 区域选择器会显示价格层级、网域映射的可用性，并突出显示碳影响最低的区域。

   4. 根据需要设置 CPU 分配和价格。

   5. 在“自动扩缩”下，指定最小和最大实例数。

   6. 根据需要设定表单中的 Ingress 设置。

   7. 在“身份验证”下，配置以下内容：

      • 如果您要创建公共 API 或网站，请选择允许未通过身份验证的调用。选中此复选框后，系统会将 IAM Invoker 角色分配给特殊标识符 allUser。您可以在创建服务后使用 IAM 修改此设置。
      • 如果您需要通过身份验证加以保护的安全服务，请选择需要身份验证。

3. 点击容器、卷、网络、安全性以在相应的标签页中设置其他可选设置：

   • 并发
   • 容器配置
   • CPU 上限
   • 内存限制
   • 请求超时
   • 密文
   • 环境变量
   • 执行环境
   • HTTP/2
   • 标签
   • 服务账号
   • Cloud SQL 连接
   • VPC 连接

4. 完成服务配置后，请点击创建以将映像部署到 Cloud Run，然后等待部署完成。

5. 点击显示的网址链接，以打开已部署服务的唯一、稳定的端点。

命令行

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

   激活 Cloud Shell

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

2. 要部署容器映像，请执行以下操作：

   1. 运行以下命令：

      gcloud run deploy SERVICE --image IMAGE_URL

      • 将 SERVICE 替换为要部署到的服务的名称。服务名称不得超过 49 个字符，并且在每个区域和项目中必须是唯一的。如果服务尚不存在，则此命令会在部署期间创建服务。您可以完全省略此参数，但如果省略它，系统将提示您输入服务名称。
      • 将 IMAGE_URL 替换为对容器映像的引用，例如 us-docker.pkg.dev/cloudrun/container/hello:latest。如果您使用 Artifact Registry，则必须预先创建制品库 REPO_NAME。网址格式为 LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG。请注意，如果您未提供 --image 标志，则部署命令将尝试从源代码进行部署。

      如果您要创建公共 API 或网站，则使用 --allow-unauthenticated 标志来允许在未通过身份验证的情况下调用服务。此操作会将 Cloud Run Invoker IAM 角色分配给 allUsers。您还可以指定 --no-allow-unauthenticated 以禁止在未通过身份验证的情况下调用。如果您省略其中任一标志，则系统会在 deploy 命令运行时提示您确认。

   2. 等待部署完成。成功完成后，系统将显示一条成功消息以及已部署服务的网址。

   请注意，如需将映像部署到其他位置，而不部署到通过 run/region gcloud 属性设置的位置，请使用以下命令：

   gcloud run deploy SERVICE --region REGION

YAML

您可以将服务规范存储在 YAML 文件中，然后使用 gcloud CLI 进行部署。

1. 创建包含以下内容的新 service.yaml 文件：

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: SERVICE
   spec:
     template:
       spec:
         containers:
         - image: IMAGE

   注意替换如下内容：

   • 将 SERVICE 替换为您的 Cloud Run 服务的名称。 服务名称不得超过 49 个字符，并且在每个区域和项目中必须是唯一的。
   • 将 IMAGE 替换为容器映像的网址。

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

2. 使用以下命令部署新服务：

   gcloud run services replace service.yaml

3. （可选）如果您想允许对服务进行未经身份验证的访问，请将服务设为公开。

Cloud Code

如需使用 Cloud Code 进行部署，请阅读 IntelliJ 和 Visual Studio Code 指南。

Terraform

如果您使用 Terraform，则使用来自 Google Cloud Platform 提供程序的 google_cloud_run_v2_service 资源在 Terraform 配置中定义服务。

1. 使用以下内容创建新的 main.tf 文件：

   provider "google" {
     project = "PROJECT-ID"
   }
   
   resource "google_cloud_run_v2_service" "default" {
     name     = "SERVICE"
     location = "REGION"
     client   = "terraform"
   
     template {
       containers {
         image = "IMAGE"
       }
     }
   }
   
   resource "google_cloud_run_v2_service_iam_member" "noauth" {
     location = google_cloud_run_v2_service.default.location
     name     = google_cloud_run_v2_service.default.name
     role     = "roles/run.invoker"
     member   = "allUsers"
   }
   

   注意替换如下内容：

   • 将 PROJECT-ID 替换为 Google Cloud 项目 ID
   • 将 REGION 替换为 Google Cloud 区域
   • 将 SERVICE 替换为您的 Cloud Run 服务的名称。 服务名称不得超过 49 个字符，并且在每个区域和项目中必须是唯一的。
   • 将 IMAGE_URL 替换为对容器映像的引用，例如 us-docker.pkg.dev/cloudrun/container/hello:latest。 如果您使用 Artifact Registry，则必须预先创建制品库 REPO_NAME。网址格式为 LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG

   此配置允许公共访问（相当于 --allow-unauthenticated）。如需将该服务设为不公开，请移除 google_cloud_run_v2_service_iam_member 节。

2. 初始化 Terraform：

   terraform init

3. 应用 Terraform 配置：

   terraform apply

   输入 yes，确认您要应用所述操作。

客户端库

如需通过代码部署新服务，请使用以下客户端库：

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• .NET

REST API

如需部署新服务，请向 Cloud Run Admin API service 端点发送 POST HTTP 请求。

例如，使用 curl：

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X POST \
  -d '{template: {containers: [{image: "IMAGE_URL"}]}}' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services?serviceId=SERVICE

您需要在其中：

• 将 ACCESS_TOKEN 替换为具有部署服务的 IAM 权限的账号的有效访问令牌。例如，如果您已登录 gcloud，则可以使用 gcloud auth print-access-token 检索访问令牌。在 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。
• 将 SERVICE 替换为您要部署到的服务的名称。服务名称不得超过 49 个字符，并且在每个区域和项目中必须是唯一的。
• 将 REGION 替换为该服务的 Google Cloud 区域。
• 将 PROJECT-ID 替换为 Google Cloud 项目 ID。

控制台

要部署现有服务的新修订版本，请执行以下操作：

1. 转到 Cloud Run

2. 在服务列表中找到要更新的服务，然后点击以打开其详细信息。

3. 点击修改和部署新的修订版本以显示修订版本部署表单。

   1. 如果需要，请提供要部署的新容器映像的网址。

   2. 根据需要配置容器。

   3. 根据需要设置 CPU 分配和价格。

   4. 在“容量”下，指定内存上限和 CPU 上限。

   5. 根据需要指定请求超时和并发。

   6. 根据需要指定执行环境。

   7. 在“自动扩缩”下，指定最小和最大实例数。

   8. 根据需要，使用其他标签页选择性地配置：

      • 密文
      • 环境变量
      • HTTP/2
      • 标签
      • 服务账号
      • Cloud SQL 连接
      • VPC 连接

4. 如需将所有流量都发送到新修订版本，请选择立即支持此修订版本。如需逐步发布新的修订版本，请取消选中该复选框。这样在部署中，系统将不会向新修订版本发送任何流量。部署后，按照逐步发布的说明进行操作。

5. 点击部署并等待部署完成。

命令行

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

   激活 Cloud Shell

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

2. 要部署容器映像，请执行以下操作：

   1. 运行以下命令：

      gcloud run deploy SERVICE --image IMAGE_URL

      • 将 SERVICE 替换为要部署到的服务的名称。您可以完全省略此参数，但如果省略它，系统将提示您输入服务名称。
      • 将 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 CLI 参数 --revision-suffix。

   2. 等待部署完成。成功完成后，系统将显示一条成功消息以及已部署服务的网址。

YAML

如果您需要下载或查看现有服务的配置，请使用以下命令将结果保存到 YAML 文件：

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

在服务配置 YAML 文件中，根据需要修改任何 spec.template 子属性以更新修订版本设置，然后部署新修订版本：

gcloud run services replace service.yaml

Cloud Code

如需使用 Cloud Code 部署现有服务的新修订版本，请阅读 IntelliJ 和 Visual Studio Code 指南。

Terraform

确保您已按照部署新服务示例中的说明设置了 Terraform。

1. 更改配置文件。

2. 应用 Terraform 配置：

   terraform apply

   输入 yes，确认您要应用所述操作。

客户端库

如需通过代码部署新的修订版本，请使用以下客户端库：

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• .NET

REST API

如需部署新的修订版本，请向 Cloud Run Admin API service 端点发送 PATCH HTTP 请求。

例如，使用 curl：

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X PATCH \
  -d '{template: {containers: [{image: "IMAGE_URL"}]}}' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services/SERVICE

您需要在其中：

• 将 ACCESS_TOKEN 替换为具有部署修订版本的 IAM 权限的账号的有效访问令牌。例如，如果您已登录 gcloud，则可以使用 gcloud auth print-access-token 检索访问令牌。在 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。
• 将 SERVICE 替换为您要部署到的服务的名称。
• 将 REGION 替换为该服务的 Google Cloud 区域。
• 将 PROJECT-ID 替换为 Google Cloud 项目 ID。

控制台

1. 转到 Cloud Run

   • 如需部署到现有服务，请在服务列表中找到服务，点击以打开它，然后点击修改和部署新修订版本以显示修订版本部署表单。
   • 如需部署到新服务，请点击创建服务。

2. 对于新服务，

   1. 提供服务名称和要部署的 Ingress 容器映像的网址。
   2. 点击容器、卷、网络、安全性

3. 在修改容器卡片中，根据需要配置 Ingress 容器。

4. 点击添加容器，然后配置要添加的 Sidecar 容器与入站流量容器。如果 Sidecar 依赖于服务中的其他容器，请在容器启动顺序下拉菜单中指明。对您要部署的每个 Sidecar 容器重复此步骤。

5. 如需将所有流量都发送到新修订版本，请选择立即支持此修订版本。对于逐步发布，请取消选中该复选框。这样在部署中，系统将不会向新修订版本发送任何流量。部署后，按照逐步发布的说明进行操作。

6. 点击创建（对于新服务）或部署（对于现有服务），然后等待部署完成。

命令行

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

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

   激活 Cloud Shell

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

2. 如需将多个容器部署到服务，请运行以下命令：

   gcloud beta run deploy SERVICE \
    --container INGRESS_CONTAINER_NAME
    --image='INGRESS_IMAGE' \
    --port='CONTAINER_PORT' \
    --container SIDECAR_CONTAINER_NAME \
    --image='SIDECAR_IMAGE'

   您需要在其中：

   • 将 SERVICE 替换为您要部署到的服务的名称。 您可以完全省略此参数，但如果省略它，系统将提示您输入服务名称。
   • 将 INGRESS_CONTAINER_NAME 替换为接收请求的容器的名称，例如 app。
   • 将 INGRESS_IMAGE 替换为对应接收请求的容器映像的引用，例如 us-docker.pkg.dev/cloudrun/container/hello:latest。
   • 将 CONTAINER_PORT 替换为入站流量容器监听传入请求的端口。与单容器服务不同，对于包含 Sidecar 的服务，入站流量容器没有默认端口。您必须为入站流量容器明确配置容器端口，并且只有一个容器可以公开该端口。
   • 将 SIDECAR_CONTAINER_NAME 替换为 Sidecar 容器的名称，例如 sidecar。
   • 将 SIDECAR_IMAGE 替换为对 Sidecar 容器映像的引用

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

   gcloud beta run deploy SERVICE \
     --container CONTAINER_1_NAME
     --image='INGRESS_IMAGE' \
     --set-env-vars=KEY=VALUE \
     --port='CONTAINER_PORT' \
     --container SIDECAR_CONTAINER_NAME
     --image='SIDECAR_IMAGE' \
     --set-env-vars=KEY_N=VALUE_N

3. 等待部署完成。成功完成后，系统将显示一条成功消息以及已部署服务的网址。

YAML

以下说明介绍了具有 Sidecar 的 Cloud Run 服务的基本 YAML 文件。创建一个名为 service.yaml 的文件，并将以下内容添加到其中：

apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  annotations:
  name: SERVICE_NAME
spec:
  template:
    spec:
      containers:
      - image: INGRESS_IMAGE
        ports:
          - containerPort: CONTAINER_PORT
      - image: SIDECAR_IMAGE
      

替换

• 将 SERVICE 替换为您的 Cloud Run 服务的名称。 服务名称不得超过 49 个字符。
• 将 CONTAINER_PORT 替换为入站流量容器监听传入请求的端口。与单容器服务不同，对于包含 Sidecar 的服务，入站流量容器没有默认端口。您必须为入站流量容器明确配置容器端口，并且只有一个容器可以公开该端口。
• 将 INGRESS_IMAGE 替换为对应接收请求的容器映像的引用，例如 us-docker.pkg.dev/cloudrun/container/hello:latest。
• 将 SIDECAR_IMAGE 替换为对 Sidecar 容器映像的引用。您可以通过向 YAML 中的 containers 数组添加更多元素来指定多个 Sidecar。

更新 YAML 以添加入站流量容器和 Sidecar 容器后，使用以下命令部署到 Cloud Run：

gcloud run services replace service.yaml

Terraform

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

将以下内容添加到 Terraform 配置中的 google_cloud_run_v2_service 资源中。

resource "google_cloud_run_v2_service" "default" {
  name     = "SERVICE"
  location = "REGION"
  ingress = "INGRESS_TRAFFIC_ALL"
  template {
    containers {
      name = "INGRESS_CONTAINER_NAME"
      ports {
        container_port = CONTAINER_PORT
      }
      image = "INGRESS_IMAGE"
      depends_on = ["SIDECAR_CONTAINER_NAME"]
    }
    containers {
      name = "SIDECAR_CONTAINER_NAME"
      image = "SIDECAR_IMAGE"
      }
    }
  }

CONTAINER_PORT 表示入站流量容器监听传入请求的端口。与单容器服务不同，对于包含 Sidecar 的服务，入站流量容器没有默认端口。您必须为入站流量容器明确配置容器端口，并且只有一个容器可以公开该端口。