快速入门：创建 Cloud Run 实例

本页面介绍了如何使用 Cloud Run 在示例容器中创建 Cloud Run 实例、查看其日志，以及使用 gcloud CLI 管理其生命周期。

准备工作

  1. 登录您的 Google Cloud 账号。如果您是新手 Google Cloud， 请创建一个账号来评估我们的产品在 实际场景中的表现。新客户还可获享 $300 赠金，用于 运行、测试和部署工作负载。

  2. 安装 Google Cloud CLI。

  3. 如果您使用的是外部身份提供方 (IdP)，则必须先使用联合身份登录 gcloud CLI。

  4. 如需初始化 gcloud CLI，请运行以下命令： 

    gcloud init

  5. 创建或选择 Google Cloud 项目。

    选择或创建项目所需角色

    • 选择项目：选择项目不需要特定的 IAM 角色，您可以选择已获授角色的任何项目。
    • 创建项目：如需创建项目，您需要 Project Creator 角色 (roles/resourcemanager.projectCreator)，该角色包含 resourcemanager.projects.create 权限。了解如何授予 角色。

    • 创建 Google Cloud 项目：

      gcloud projects create PROJECT_ID

      将 PROJECT_ID 替换为您要创建的 Google Cloud 项目的名称。

    • 选择您创建的 Google Cloud 项目：

      gcloud config set project PROJECT_ID

      将 PROJECT_ID 替换为您的 Google Cloud 项目名称。

  6. 如果您要使用现有项目来完成本指南， 请验证您是否拥有完成本指南所需的权限。如果您创建了新项目， 则您已拥有所需的权限。

  7. 验证是否已为您的 Google Cloud 项目启用结算功能。

  8. 启用 Cloud Run Admin API 和 Cloud Logging API：

    启用 API 所需的角色

    如需启用 API，您需要拥有 serviceusage.services.enable 权限。如果您 创建了项目，则您可能已通过 Owner 角色 (roles/owner) 拥有此权限。否则，您可以通过 Service Usage Admin 角色 (roles/serviceusage.serviceUsageAdmin) 获得此权限。 了解如何授予角色。 

    gcloud services enable run.googleapis.com logging.googleapis.com

  9. 安装 Google Cloud CLI。

  10. 如果您使用的是外部身份提供方 (IdP)，则必须先使用联合身份登录 gcloud CLI。

  11. 如需初始化 gcloud CLI，请运行以下命令： 

    gcloud init

  12. 创建或选择 Google Cloud 项目。

    选择或创建项目所需角色

    • 选择项目：选择项目不需要特定的 IAM 角色，您可以选择已获授角色的任何项目。
    • 创建项目：如需创建项目，您需要 Project Creator 角色 (roles/resourcemanager.projectCreator)，该角色包含 resourcemanager.projects.create 权限。了解如何授予 角色。

    • 创建 Google Cloud 项目：

      gcloud projects create PROJECT_ID

      将 PROJECT_ID 替换为您要创建的 Google Cloud 项目的名称。

    • 选择您创建的 Google Cloud 项目：

      gcloud config set project PROJECT_ID

      将 PROJECT_ID 替换为您的 Google Cloud 项目名称。

  13. 如果您要使用现有项目来完成本指南， 请验证您是否拥有完成本指南所需的权限。如果您创建了新项目， 则您已拥有所需的权限。

  14. 验证是否已为您的 Google Cloud 项目启用结算功能。

  15. 启用 Cloud Run Admin API 和 Cloud Logging API：

    启用 API 所需的角色

    如需启用 API，您需要拥有 serviceusage.services.enable 权限。如果您 创建了项目，则您可能已通过 Owner 角色 (roles/owner) 拥有此权限。否则，您可以通过 Service Usage Admin 角色 (roles/serviceusage.serviceUsageAdmin) 获得此权限。 了解如何授予角色。 

    gcloud services enable run.googleapis.com logging.googleapis.com
    16.
  16. 如需为 Cloud Run 实例设置默认项目，请执行以下操作： 
    gcloud config set project PROJECT_ID
     将 PROJECT_ID 替换为您为此快速入门创建的项目的名称。
  17. 确保您已安装 gcloud beta 组件： 
    gcloud components install beta
  18. 查看 Cloud Run 价格或使用价格计算器估算费用 。

所需的角色

如需获得完成本教程所需的权限，请让您的管理员为您授予以下 IAM 角色：

如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

创建实例

如需使用 gcloud CLI 在示例容器中创建 Cloud Run 实例，请执行以下操作：

  1. 运行以下命令：

    gcloud beta run instances create my-instance \
--image us-docker.pkg.dev/cloudrun/container/hello \
--region REGION \
--port 8080 \
--no-invoker-iam-check

    将 REGION 替换为受支持的 Google Cloud 区域。

    通过 --no-invoker-iam-check 标志，您可以停用 IAM 调用方身份验证，从而在不进行 IAM 身份验证的情况下访问实例网址。

  2. 等待实例创建完成。完成后，该命令会显示类似如下所示的输出：

    Creating instance...
Importing container..............done
Provisioning resources.......done
Starting instance.....done
Done.
Instance [my-instance] has successfully been created.

URL: https://my-instance-PROJECT-NUMBER.REGION.run.app

  3. 在浏览器中打开返回的网址，与正在运行的容器互动。

查看实例日志

如需查看 Cloud Run 实例生成的日志，请执行以下操作：

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

    转到 Logs Explorer

  2. 过滤日志以查找特定实例：

    resource.type="cloud_run_instance"
resource.labels.location="<var>REGION</var>"
resource.labels.instance_name="my-instance"

清理

为避免因本页中使用的资源导致您的 Google Cloud 账号产生费用，请按照以下步骤操作。

删除实例

如需停止并删除 Cloud Run 实例，请执行以下操作：

gcloud beta run instances delete my-instance --region REGION

删除测试项目

删除您的 Google Cloud 项目后，系统即会停止对该 项目中的所有资源计费。如需释放项目中的所有 Google Cloud 资源，请按照以下步骤操作：

    删除 Google Cloud 项目：

    gcloud projects delete PROJECT_ID

后续步骤

如需详细了解 Cloud Run 实例，请参阅：