开始

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

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

准备工作

  1. 登录您的 Google 帐号。

    如果您还没有 Google 帐号，请注册新帐号。

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

    转到项目选择器页面

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

  4. 启用 Cloud Life Sciences API。

    启用 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 命令行工具。

  1. 下载并安装 Cloud SDK。

  2. 初始化 Cloud SDK。

  3. 初始化 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 的工具，请完成以下步骤，以下载项目的服务帐号密钥文件。

  1. 登录您的 Google 帐号。

    如果您还没有 Google 帐号，请注册新帐号。

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

    转到项目选择器页面

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

  4. 启用 Cloud Life Sciences and Cloud Storage JSON API。

    启用 API

  5. 打开 API 控制台中的凭据页面。
  6. 点击创建凭据 > 服务帐号。
  7. 在服务帐号详情页面上，输入服务帐号名称，然后点击创建。
  8. 在服务帐号权限页面上，选择服务帐号的角色。如需授予对 Cloud Life Sciences 最广泛的访问权限，请选择 Cloud Life Sciences > Cloud Life Sciences Workflows Runner，然后点击继续。
  9. 可选：填写向用户授予访问此服务帐号的权限页面。
  10. 点击完成。

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

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

    转到“服务帐号”页面

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

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

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

后续步骤