JupyterLab で Cloud Storage バケットとファイルにアクセスする

このページでは、Cloud Storage に保存されているファイルを参照できるように、Cloud Storage バケットを Gemini Enterprise Agent Platform Workbench インスタンスの JupyterLab インターフェースにマウントする方法について説明します。テキスト ファイルやノートブック（IPYNB）ファイルなど、JupyterLab と互換性のあるファイルを開いて編集することもできます。

概要

Agent Platform Workbench インスタンスには、Cloud Storage バケットをマウントできる Cloud Storage インテグレーションが含まれています。つまり、JupyterLab インターフェース内からバケットの内容を参照し、互換性のあるファイルを操作できます。

Agent Platform Workbench インスタンスと同じプロジェクト内でインスタンスがアクセスできる任意の Cloud Storage バケットとファイルにアクセスできます。

始める前に

  1. アカウントにログインします。 Google Cloud を初めて使用する場合は、 アカウントを作成して、実際のシナリオで Google プロダクトのパフォーマンスを評価してください。 Google Cloud新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。

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

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Notebooks API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

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

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Notebooks API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

    8.

必要なロール

Cloud Storage バケットを Agent Platform Workbench インスタンスにマウントするために必要な権限を取得するには、次の IAM ロールを付与するよう管理者に依頼してください。

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

共有ストレージのマウントを有効にするために必要な権限

Agent Platform Workbench インスタンスで共有ストレージのマウントを有効にするには、Agent Platform Workbench インスタンスのサービス アカウントにプロジェクトに対する storage.buckets.list 権限を付与するよう、管理者に依頼してください。

Agent Platform Workbench インスタンスの JupyterLab インターフェースに [Mount shared storage] ボタンを表示するには、storage.buckets.list 権限が必要です。

バケットと Agent Platform Workbench インスタンスを作成する

Agent Platform Workbench インスタンスと同じプロジェクト内の 1 つ以上の Cloud Storage バケットにアクセスできる必要があります。
  1. Cloud Storage バケットを作成する必要がある場合は、 バケットを作成するをご覧ください。
  2. まだ作成していない場合は、 Cloud Storage バケットと同じプロジェクトに Agent Platform Workbench インスタンスを作成します。

JupyterLab を開く

  1. Google Cloud コンソールで [インスタンス] ページに移動します。

    [Spanner インスタンス] に移動

  2. Agent Platform Workbench インスタンスの名前の横にある [**Open JupyterLab**] をクリックします。

    Agent Platform Workbench インスタンスで JupyterLab が開きます。

Cloud Storage バケットをマウントする

Cloud Storage バケットをマウントしてアクセスする手順は次のとおりです。

  1. JupyterLab で、[ File Browser] タブが選択されていることを確認します。

  2. 左側のサイドバーで、 [Mount shared storage] ボタンをクリックします。このボタンが表示されない場合は、サイドバーの右側をドラッグして、ボタンが表示されるまでサイドバーを開きます。

    左側のサイドバーの右上にある [Mount shared storage] ボタン

  3. [Bucket name] フィールドに、マウントする Cloud Storage バケット名を入力します。

  4. [Mount] をクリックします。

  5. Cloud Storage バケットは、左側のサイドバーの [File browser] タブにフォルダとして表示されます。フォルダをダブルクリックして開き、内容を確認します。

トラブルシューティング

Cloud Storage バケットをインスタンスにマウントする際の問題を診断して解決する方法については、Agent Platform Workbench のトラブルシューティングをご覧ください。

次のステップ