使ってみる

このページでは、Cloud Life Sciences API の使用に必要な設定手順について説明します。

（クイックスタートを完了している場合は、この手順の一部はすでに完了しています。このページをご覧いただき、Cloud Life Sciences API を使用する準備が整ったことを確認してください）。

始める前に

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Cloud Life Sciences API.

    Enable the API

    5.

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Cloud Life Sciences API.

    Enable the API

    8.

サービス アカウントとデフォルトのロールについて理解する

パイプラインを初めて実行すると（gcloud CLI、または RPC API と REST API を使用）、次の認証手順が実行されます。

  1. Cloud Life Sciences Service Agent というサービス アカウントが作成されます。
  2. サービス アカウントには、デフォルトのロール lifesciences.workflowsRunner が自動的に割り当てられます。このロールは、プロジェクト内の Compute Engine インスタンスを開始および停止できるようにします。

後で、関連するプロジェクトのサービス アカウントからデフォルトの役割を削除すると、次のエラーが発生する可能性があります。

  • API を使用してパイプラインを実行しようとすると、権限エラーが発生します。この問題を解決するには、トラブルシューティングをご覧ください。
  • パイプラインが完了した時点で、API は実行中のインスタンスをシャットダウンできず、これらのリソースは引き続き課金されます。この問題を解決するには、トラブルシューティングをご覧ください。

Google Cloud CLI と Google Cloud CLI の設定

Google Cloud CLI をインストールして、Cloud Life Sciences、Compute Engine、Cloud Storage、BigQuery でツールとライブラリを使用します。SDK には gcloud、gsutil、bq コマンドライン ツールが含まれています。

  1. Google Cloud CLI をダウンロードして、インストールします。

  2. Google Cloud CLI を初期化します。

  3. SDK を初期化したら、Cloud Life Sciences コンポーネントをインストールします。

    gcloud components update beta

    gcloud CLI のデフォルト インストールで Compute Engine VM を使用している場合は、前述のコマンドを使用してコンポーネントをインストールできません。Compute Engine VM で Cloud Life Sciences API を有効にするには、次のコマンドを実行して gcloud CLI を再インストールします。

    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 リポジトリのコードサンプル
  • Cloud Life Sciences API に直接アクセスする Google Cloud CLI 以外のツール

サービス アカウント キーファイルを作成するには、次の手順を行います。

  1. Google Cloud Console の [認証情報] ページに移動します。

    [ドメインの確認] ページに移動

  2. [認証情報を作成] > [サービス アカウント] をクリックします。

  3. [サービス アカウントの詳細] ページで、サービス アカウント名を入力し、[作成] をクリックします。

  4. [このサービス アカウントにプロジェクトへのアクセスを許可する] タブで、サービス アカウントのロールを選択します。Cloud Life Sciences への広範囲のアクセスについては、[Cloud Life Sciences] > [Cloud Life Sciences ワークフロー実行者] を選択して、[続行] をクリックします。

  5. （省略可）[ユーザーにこのサービス アカウントへのアクセスを許可] タブに情報を入力します。

  6. [完了] をクリックします。

サービス アカウント キーをダウンロードするには、次の手順を行います。

  1. Google Cloud Console の [サービス アカウント] ページに移動します。

    [サービス アカウント] ページに移動

  2. キーを作成するサービス アカウントの行を見つけます。、[キーの管理] の順にクリックします。

  3. [キー] ページで [キーを追加] をクリックし、[新しいキーを作成] をクリックします。

  4. [JSON] には [JSON] を選択し、[JSON] をクリックします。

[作成] をクリックすると、サービス アカウント キーファイルがダウンロードされます。このファイルはサービス アカウントとしての認証に使用できるため、安全な場所に保管してください。このファイルは移動したり、名前を変更したりできます。

次のステップ