Cloud Storage を使用してファイルをバックアップおよび復元する

このページでは、Cloud Storage を使用して Gemini Enterprise Agent Platform Workbench インスタンスのファイルをバックアップおよび復元する方法について説明します。

概要

このガイドでは、Cloud Storage を使用して Agent Platform Workbench インスタンスのファイルのバックアップと復元を行う 2 つの方法について説明します。

始める前に

  1. Google Cloud アカウントにログインします。 Google Cloudを初めて使用する場合は、 アカウントを作成して、実際のシナリオでの Google プロダクトのパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $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 ロールを付与するよう管理者に依頼してください。

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

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

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

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

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

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

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

Agent Platform Workbench インスタンスの JupyterLab インターフェースに [共有ストレージをマウント] ボタンを表示するには、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 インスタンス名の横にある [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 にエクスポートしてファイルを復元する

このセクションでは、Cloud Storage にファイルをエクスポートする方法と、Cloud Storage バケットにあるファイルを復元する方法について説明します。

Cloud Storage にエクスポートする

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

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

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

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

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

  4. 左側のサイドバーで、 [GCS にエクスポート] ボタンをクリックします。このボタンが表示されない場合は、サイドバーの右側をドラッグして、ボタンが表示されるまでサイドバーを開きます。

  5. [Provide export location] ダイアログで、ファイルのエクスポート先となる Cloud Storage バケット名を入力します。Cloud Storage バケットを作成する必要がある場合は、バケットを作成するをご覧ください。

    Agent Platform Workbench で、インスタンスのファイルを Cloud Storage にエクスポートするコードを含む新しいノートブックが開きます。

  6. このセル内のコードを実行します。

Cloud Storage からファイルを復元する

ファイルを Agent Platform Workbench インスタンスに復元するには、gcloud storage cp を使用してファイルをコピーします。

インスタンスのいずれかのノートブックのセルで次のコードを実行します。

!gcloud storage cp URI /home/jupyter/FILE_NAME

次のように置き換えます。

  • URI: コピーするファイルの gsutil URI（例: gs://BUCKET_NAME/ZONE/INSTANCE_ID/FILE_NAME）
  • FILE_NAME: コピーするファイルの名前

詳細については、バケットからオブジェクトをダウンロードするをご覧ください。

次のステップ