ユーザー管理ノートブックインスタンスの特定のバージョンを作成する

このページでは、特定の Deep Learning VM Image のバージョンに基づいてユーザー管理のノートブックインスタンスを作成する方法について説明します。

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

ユーザー管理のノートブックインスタンスに、コードやアプリケーションと互換性のあるソフトウェアが確実に含まれるように、特定のバージョンを作成できます。

ユーザー管理のノートブックインスタンスは、Deep Learning VM Image を使用して作成されます。Deep Learning VM イメージは頻繁に更新されているため、プリインストールされるソフトウェアとパッケージはバージョンによって異なります。

特定の Deep Learning VM バージョンの詳細については、Deep Learning VM リリースノートをご覧ください。

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

始める前に

ユーザー管理のノートブックインスタンスを作成する前に、Google Cloud プロジェクトを準備し、そのプロジェクトで Notebooks API を有効にする必要があります。

Google Cloud Console の [プロジェクトセレクタ] ページで、Google Cloud プロジェクトを選択または作成します。

注: この手順で作成するリソースをそのまま保持する予定でない場合、既存のプロジェクトを選択するのではなく、新しいプロジェクトを作成してください。チュートリアルの終了後にそのプロジェクトを削除すれば、プロジェクトに関連するすべてのリソースを削除できます。

プロジェクトセレクタに移動

Google Cloud プロジェクトで課金が有効になっていることを確認します。

Notebooks API を有効にします。
API を有効にする

ユーザー管理のノートブックインスタンスで GPU を使用する場合は、Google Cloud コンソールの [割り当て] ページで、プロジェクトに使用できる GPU が十分であることを確認してください。GPU が [割り当て] ページのリストにない場合や、さらに GPU 割り当てが必要な場合は、割り当て量の増加をリクエストしてください。Compute Engine のリソースの割り当てページの割り当て量の増加をリクエストするをご覧ください。

必要なロール

プロジェクトを作成した場合、そのプロジェクトに対するオーナー（roles/owner）IAM ロールが付与されています。このロールには、必要な権限がすべて含まれています。このセクションをスキップして、ユーザー管理のノートブックインスタンスの作成を開始します。プロジェクトを自分で作成していない場合は、このセクションに進んでください。

Vertex AI Workbench ユーザー管理ノートブックインスタンスの作成に必要な権限がユーザーアカウントに付与されるように、プロジェクトに対する次の IAM ロールをユーザーアカウントに付与するよう管理者に依頼してください。

Notebooks 管理者（roles/notebooks.admin）
サービスアカウントユーザー（roles/iam.serviceAccountUser）

ロールの付与の詳細については、アクセスの管理をご覧ください。

管理者は、カスタムロールや他の事前定義ロールを使用して、必要な権限をユーザーアカウントに付与することもできます。

特定のバージョンを見つける

特定の Deep Learning VM バージョンに基づいてユーザー管理のノートブックインスタンスを作成するには、使用する Deep Learning VM バージョンのイメージ名を確認する必要があります。

Deep Learning VM の各リリースには異なるイメージに対するアップデートが含まれています。リリース内の各イメージには独自のイメージ名が付いています。

必要なイメージ名を確認するには:

イメージ名を取得する Deep Learning VM リリース番号を探します。リリース番号は Deep Learning VM リリースノートに記載されています。リリース番号は、M の後にリリース番号が続く形式になっています（例: M79）。
特定の Deep Learning VM リリースのイメージ名を一覧表示するには、次のコマンドを実行します。
```
gcloud compute images list --project="deeplearning-platform-release" \
    --format="value(name)" \
    --filter="labels.release=RELEASE_NUMBER" \
    --show-deprecated
```
RELEASE_NUMBER は、Deep Learning VM のリリース番号（M79 など）で置き換えます。
使用するイメージ名を探します。

コマンドラインから特定のバージョンを作成する

コマンドラインから特定のバージョンのユーザー管理ノートブックインスタンスを作成するには、次の手順を行います。

gcloud notebooks コマンドを実行します。
```
gcloud notebooks instances create INSTANCE_NAME \
    --vm-image-project="deeplearning-platform-release" \
    --vm-image-name=VM_IMAGE_NAME \
    --machine-type=MACHINE_TYPE \
    --location=LOCATION
```
次のように置き換えます。
- INSTANCE_NAME: 新しいインスタンスの名前
- VM_IMAGE_NAME: インスタンスの作成に使用するイメージ名
- MACHINE_TYPE: インスタンスの VM のマシンタイプ
- LOCATION: 新しいインスタンスを配置する Google Cloud のロケーション
Google Cloud Console からインスタンスにアクセスします。

次のステップ

ユーザー管理のノートブックインスタンスのアップグレードについて確認し、準備が整った場合にのみインスタンスがアップグレードされるように設定する。
新しいユーザー管理のノートブックインスタンスに依存関係をインストールする。
Deep Learning VM のドキュメントで Deep Learning VM インスタンスの詳細を学習する。
ユーザー管理のノートブックインスタンスのヘルスステータスのモニタリングについて学習する。