特定のバージョンの Vertex AI Workbench インスタンスを作成する

このページでは、特定のバージョンの Vertex AI Workbench インスタンスを作成する方法について説明します。

特定のバージョンを作成する理由

Vertex AI Workbench インスタンスにコードやアプリケーションとの互換性があるソフトウェアが存在するようにするために、特定のバージョンを作成できます。

Vertex AI Workbench インスタンス イメージは頻繁に更新されるため、プリインストールされるソフトウェアとパッケージのバージョンは異なります。

特定の Vertex AI Workbench バージョンの詳細については、Agent Platform リリースノートをご覧ください。

特定のバージョンの Vertex AI Workbench インスタンスを作成したら、それをアップグレードできます。インスタンスをアップグレードすると、プリインストールされているソフトウェアとパッケージが更新されます。詳細については、インスタンスの環境をアップグレードするをご覧ください。

始める前に

  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.

特定のバージョンを作成する

Google Cloud コンソールまたは Google Cloud CLI を使用して、特定のバージョンの Vertex AI Workbench インスタンスを作成できます。

コンソール

特定のバージョンの Vertex AI Workbench インスタンスを作成するには、次の操作を行います。

  1. インスタンスを作成する場合は、[環境] セクションで [以前のバージョンを使用する] を選択します。

  2. [バージョン] リストをクリックして、バージョンを選択します。バージョンの番号は、M の後にリリース番号が続く形式になっています（例: M123）。

  3. インスタンス作成ダイアログの残りの部分に入力して、[作成] をクリックします。

    Vertex AI Workbench がインスタンスを作成し、自動的に起動します。インスタンスを使用する準備が整うと、Vertex AI Workbench で [JupyterLab を開く] が有効になります。

gcloud

後述のコマンドデータを使用する前に、次のように置き換えます。

  • INSTANCE_NAME: Vertex AI Workbench インスタンスの名前。先頭は英字で、それに続く最大 62 文字の英小文字、数字、ハイフン（-）で構成します。末尾にハイフンは使用できません。
  • PROJECT_ID: プロジェクト ID
  • LOCATION: インスタンスを配置するゾーン
  • VM_IMAGE_NAME: イメージ名。使用可能なイメージ名のリストを取得するには、get-config コマンドを使用します。
  • MACHINE_TYPE: インスタンスの VM のマシンタイプ

  • METADATA: このインスタンスに適用するカスタム メタデータ。たとえば、起動後スクリプトを指定するには、post-startup-script メタデータタグを --metadata=post-startup-script=gs://BUCKET_NAME/hello.sh の形式で使用してください。

次のコマンドを実行します。

Linux、macOS、Cloud Shell

gcloud workbench instances create INSTANCE_NAME \
    --project=PROJECT_ID \
    --location=LOCATION \
    --vm-image-project="cloud-notebooks-managed" \
    --vm-image-name=VM_IMAGE_NAME \
    --machine-type=MACHINE_TYPE \
    --metadata=METADATA

Windows（PowerShell）

gcloud workbench instances create INSTANCE_NAME `
    --project=PROJECT_ID `
    --location=LOCATION `
    --vm-image-project="cloud-notebooks-managed" `
    --vm-image-name=VM_IMAGE_NAME `
    --machine-type=MACHINE_TYPE `
    --metadata=METADATA

Windows（cmd.exe）

gcloud workbench instances create INSTANCE_NAME ^
    --project=PROJECT_ID ^
    --location=LOCATION ^
    --vm-image-project="cloud-notebooks-managed" ^
    --vm-image-name=VM_IMAGE_NAME ^
    --machine-type=MACHINE_TYPE ^
    --metadata=METADATA

コマンドラインからインスタンスを作成するコマンドの詳細については、gcloud CLI のドキュメントをご覧ください。

Vertex AI Workbench がインスタンスを作成し、自動的に起動します。インスタンスを使用する準備が整うと、Vertex AI Workbench により Google Cloud コンソールの [JupyterLab を開く] リンクが有効化されます。

次のステップ