本页面将引导您完成使用 Cloud Life Sciences API 所需的设置步骤。
(如果您已完成快速入门,则您已完成其中一些步骤。请查看本页面,确保您已准备好使用 Cloud Life Sciences API。)
准备工作
-
登录您的 Google 帐号。
如果您还没有 Google 帐号,请注册新帐号。
-
在 Google Cloud Console 的项目选择器页面上,选择或创建一个 Google Cloud 项目。
-
确保您的 Cloud 项目已启用结算功能。 了解如何确认您的项目是否已启用结算功能。
- 启用 Cloud Life Sciences API。
当您首次在 Google Cloud 项目中运行流水线(使用 gcloud
工具或 RPC 和 REST API)时,系统会自动为项目的新服务帐号分配一个角色 (lifesciences.workflowsRunner
),该角色可以启动和停止项目中的 Compute Engine 实例。
如果稍后从相关项目服务帐号中移除此默认角色,则可能会遇到错误。 特别是,尝试使用 API 运行流水线将导致出现权限错误。 当流水线运行完成时,API 也将无法关闭正在运行的实例,系统将继续为这些资源向您收取费用。如需详细了解如何解决此问题,请参阅问题排查。
设置 Cloud SDK 和 gcloud
命令行工具
安装 Cloud SDK 以使用 Cloud Life Sciences、Compute Engine、Cloud Storage 和 BigQuery 中的工具和库。SDK 包含 gcloud
、gsutil
和 bq
命令行工具。
初始化 SDK 后,安装 Cloud Life Sciences 命令:
gcloud components update beta
如果您通过
gcloud
工具的默认安装的使用 Compute Engine 虚拟机,您将无法更新这些组件。要在 Compute Engine 虚拟机上启用 Cloud Life Sciences API,请运行以下命令重新安装gcloud
命令行工具:sudo apt-get remove google-cloud-sdk curl https://sdk.cloud.google.com | bash exec -l $SHELL gcloud init
下载 API 访问的凭据
如果您使用的是 Cloud Life Sciences GitHub 代码库中的代码示例,或 gcloud
命令行工具以外的可直接访问 Cloud Life Sciences API 的工具,请完成以下步骤,以下载项目的服务帐号密钥文件。
-
登录您的 Google 帐号。
如果您还没有 Google 帐号,请注册新帐号。
-
在 Google Cloud Console 的项目选择器页面上,选择或创建一个 Google Cloud 项目。
-
确保您的 Cloud 项目已启用结算功能。 了解如何确认您的项目是否已启用结算功能。
- 启用 Cloud Life Sciences and Cloud Storage JSON API。
- 打开 API 控制台中的凭据页面。
- 点击创建凭据 > 服务帐号。
- 在服务帐号详情页面上,输入服务帐号名称,然后点击创建。
- 在服务帐号权限页面上,选择服务帐号的角色。如需授予对 Cloud Life Sciences 最广泛的访问权限,请选择 Cloud Life Sciences > Cloud Life Sciences Workflows Runner,然后点击继续。
- 可选:填写向用户授予访问此服务帐号的权限页面。
- 点击完成。
要下载服务帐号密钥,请完成以下步骤:
在 Cloud Console 中,转到服务帐号页面。
找到您要为其创建密钥的服务帐号对应的行。在该行中,点击
,然后点击创建密钥。 按钮选择 JSON 作为密钥类型,然后点击创建。
点击创建即会下载服务帐号密钥文件。务必要安全存储此文件,因为它能够以服务帐号的身份进行身份验证。您可以根据需要移动并重命名此文件。