快速入门：创建 Cloud Run 实例

快速入门：创建 Cloud Run 实例

预览版 - Cloud Run 实例

此功能 受 服务专用 条款的“通用服务条款”部分中的“非正式版产品条款”的约束。 非正式版功能“按原样”提供，可能只能获得有限的支持。 如需了解详情，请参阅 发布阶段说明。

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

准备工作

1. 安装 Google Cloud CLI。

   注意：如果您之前安装了 gcloud CLI，请确保通过运行 gcloud components update 来获得最新版本。

2. 配置 gcloud CLI 以使用您的联合身份。

   如需了解详情，请参阅使用联合身份登录 gcloud CLI。

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

   gcloud init

4. 创建或选择 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 项目名称。

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

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

7. 启用 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

8. 如需为 Cloud Run 实例设置默认项目，请执行以下操作：

   gcloud config set project PROJECT_ID

   将 PROJECT_ID 替换为您为此快速入门创建的项目的名称。
9. 确保您已安装 gcloud beta 组件：

   gcloud components install beta

10. 查看 Cloud Run 价格或使用价格计算器估算费用 。

所需的角色

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

• 实例的 Cloud Run Admin (roles/run.admin) 角色
• 服务身份的 Service Account User (roles/iam.serviceAccountUser) 角色
• 项目的 Logs Viewer (roles/logging.viewer) 角色

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

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

创建实例

如需使用 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 资源，请按照以下步骤操作：

警告：删除项目会产生以下影响
• 项目中的所有内容都会被删除。如果您将现有项目用于本文档中的任务，则删除该项目后，还将删除您已在该项目中完成的任何其他工作。
• 自定义项目 ID 丢失。创建此项目时，您可能创建了要在将来使用的自定义项目 ID。要保留使用该项目 ID 的网址（例如 appspot.com 网址），请删除项目内的所选资源，而不是删除整个项目。

删除 Google Cloud 项目：

gcloud projects delete PROJECT_ID

后续步骤

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

• 创建和管理 Cloud Run 实例
• Cloud Run 实例生命周期