开始

本页面将引导您完成使用 Cloud Life Sciences API 所需的设置步骤。

（如果您已完成快速入门，则您已完成其中一些步骤。请查看本页面，确保您已准备好使用 Cloud Life Sciences API。）

准备工作

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

  2. 在 Google Cloud Console 的项目选择器页面上，选择或创建一个 Google Cloud 项目。

    转到“项目选择器”

  3. 确保您的 Cloud 项目已启用结算功能。 了解如何确认您的项目是否已启用结算功能。

  4. 启用 Cloud Life Sciences API。

    启用 API

    5.

  5. 在 Google Cloud Console 的项目选择器页面上，选择或创建一个 Google Cloud 项目。

    转到“项目选择器”

  6. 确保您的 Cloud 项目已启用结算功能。 了解如何确认您的项目是否已启用结算功能。

  7. 启用 Cloud Life Sciences API。

    启用 API

    8.

了解服务帐号和默认角色

首次运行流水线（使用 gcloud 工具或 RPC 和 REST API）时，需要执行以下身份验证步骤：

  1. 创建一个服务帐号，名为 Cloud Life Sciences Service Agent 服务帐号。
  2. 系统会自动为该服务帐号分配默认角色 lifesciences.workflowsRunner。该角色可以启动和停止项目中的 Compute Engine 实例。

如果稍后从相关项目服务帐号中移除默认角色，则可能会遇到以下错误：

  • 尝试使用 API 运行流水线会导致出现权限错误。如需解决此问题，请参阅问题排查。
  • 当流水线运行完成时，API 无法关闭正在运行的实例，系统将继续为这些资源向您收取费用。如需解决此问题，请参阅问题排查。

设置 Cloud SDK 和 gcloud 命令行工具

安装 Cloud SDK 以使用 Cloud Life Sciences、Compute Engine、Cloud Storage 和 BigQuery 中的工具和库。SDK 包含 gcloud、gsutil 和 bq 命令行工具。

  1. 下载并安装 Cloud SDK。

  2. 初始化 Cloud SDK。

  3. 初始化 SDK 后，安装 Cloud Life Sciences 组件：

    gcloud components update beta

    如果您将 Compute Engine 虚拟机与 gcloud 工具的默认安装搭配使用，则无法使用前面的命令安装这些组件。如需在 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 API，则必须下载项目的服务帐号密钥文件：

  • Cloud Life Sciences GitHub 代码库中的代码示例
  • gcloud 命令行工具以外的工具，用于直接访问 Cloud Life Sciences API

完成以下步骤以创建服务帐号密钥文件：

  1. 转到 Cloud Console 中的凭据页面。

    转到“凭据”页面

  2. 点击创建凭据 > 服务帐号。

  3. 在服务帐号详情页面上，输入服务帐号名称，然后点击创建。

  4. 在向此服务帐号授予对项目的访问权限标签页中，选择服务帐号的角色。如需授予对 Cloud Life Sciences 最广泛的访问权限，请选择 Cloud Life Sciences > Cloud Life Sciences Workflows Runner，然后点击继续。

  5. （可选）填写向用户授予访问此服务帐号的权限标签页。

  6. 点击完成。

要下载服务帐号密钥，请完成以下步骤：

  1. 在 Cloud Console 中，转到服务帐号页面。

    转到“服务帐号”页面

  2. 找到您要为其创建密钥的服务帐号对应的行。在该行中，点击，然后点击管理密钥。

  3. 在密钥页面上，点击添加密钥，然后点击创建新密钥。

  4. 选择 JSON 作为密钥类型，然后点击创建。

点击创建即会下载服务帐号密钥文件。务必要安全存储此文件，因为它能够以服务帐号的身份进行身份验证。您可以移动和重命名此文件。

后续步骤