Colab Enterprise でランタイムを作成する

このページでは、Vertex AI でランタイムを作成、開始、削除する方法について説明します。

ランタイムを作成して、デフォルトとは異なる構成のランタイムでコードを実行できます。ランタイムは、マシンタイプやディスクサイズなどの仕様を含むランタイム テンプレートに基づいて作成されます。

ランタイムの詳細については、ランタイムとランタイム テンプレートをご覧ください。

始める前に

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.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

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

4. Enable the Vertex AI, Dataform, and Compute Engine APIs.

   Enable the APIs

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

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

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

7. Enable the Vertex AI, Dataform, and Compute Engine APIs.

   Enable the APIs

必要なロール

Colab Enterprise でランタイムを作成するために必要な権限がユーザー アカウントに付与されるように、プロジェクトに対する Colab Enterprise 管理者（roles/aiplatform.colabEnterpriseAdmin）IAM ロールのユーザー アカウントへの付与を管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

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

1 つ以上の必須ロールに dataform.repositories.list 権限が含まれています。プロジェクトで dataform.repositories.list 権限またはコード作成者（roles/dataform.codeCreator）ロールが付与されているユーザーは、Dataform API または Dataform コマンドライン インターフェース（CLI）を使用して、そのプロジェクトのコードアセットの名前を一覧取得できます。BigQuery Studio を使用する管理者以外のユーザーは、自身が作成したコードアセットまたは自分と共有されているコードアセットのみを表示できます。

ランタイムを作成する

ランタイムを作成するには:

1. Google Cloud コンソールで、Colab Enterprise の [ランタイム] ページに移動します。

   [ランタイム] に移動

2. [リージョン] メニューで、ランタイムを配置するリージョンを選択します。ランタイムを使用するノートブックと同じリージョンにする必要があります。

3. [ ランタイムを作成] をクリックします。

   [Vertex AI ランタイムの作成] ダイアログが表示されます。

4. [ランタイム テンプレート] メニューで、ランタイム テンプレートを選択します。ランタイム テンプレートがリストにない場合は、ランタイム テンプレートを作成します。

5. [ランタイム名] フィールドにランタイムの名前を入力します。

6. [作成] をクリックします。

デフォルトでは、ランタイムを作成すると、そのランタイムの削除と開始に必要な権限が自動的に付与されます。

ランタイムを開始する

ランタイムを開始するには:

1. Google Cloud コンソールで、Colab Enterprise の [ランタイム] ページに移動します。

   [ランタイム] に移動

2. [リージョン] メニューで、ランタイムを含むリージョンを選択します。

3. 起動するランタイムを選択します。

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

ランタイムを削除する

ランタイムを削除するには:

1. Google Cloud コンソールで、Colab Enterprise の [ランタイム] ページに移動します。

   [ランタイム] に移動

2. [リージョン] メニューで、ランタイムを含むリージョンを選択します。

3. 削除するランタイムを選択します。

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

5. [確認] をクリックします。

トラブルシューティング

このセクションでは、Colab Enterprise でのランタイム作成に関する問題を解決する方法について説明します。

ランタイムを作成できない

この問題は、ランタイムを作成できない場合に発生します。デフォルトのランタイムを作成できないもご覧ください。最も一般的な原因は次のとおりです。

割り当て不足

ランタイムを作成できない場合、Compute Engine ランタイムの割り当てを超過している可能性があります。

Colab Enterprise では、ランタイムに Compute Engine の割り当てを使用します。詳細については、Compute Engine の割り当てと上限の概要をご覧ください。

この問題を解決するには、割り当て上限の引き上げをリクエストします。

リソースを利用できない

ランタイムを作成しようとすると、次のエラーが発生します。

No available zone found for runtime RUNTIME_ID
for machine type MACHINE_TYPE
with accelerator type: ACCELERATOR. Please try again later.

このエラーは、ノートブックのリージョン内にマシンタイプ構成で使用できるリソースがない場合に発生します。

この問題を解決するには、別のマシンタイプ構成でランタイムを試すか、しばらくしてからもう一度お試しください。

デフォルトのランタイムがすでに存在する

デフォルトのランタイムがすでに存在する場合に、デフォルトのランタイム テンプレートからランタイムを作成しようとすると、次のエラーが発生します。

Failed to create runtime

One click runtime already exists.

デフォルトのランタイム テンプレートからランタイムを作成しようとすると、Colab Enterprise はデフォルトのランタイムの作成を試みます。デフォルトのランタイムは、ユーザー、プロジェクト、リージョンごとに 1 つだけ作成できます。デフォルトのランタイムがすでに存在するときに、Colab Enterprise が別のデフォルトのランタイムを作成することはできません。

この問題を解決するには、既存のデフォルトのランタイムに接続するか、デフォルト以外のランタイム テンプレートからランタイムを作成します。

デフォルトのランタイムを作成できない

Colab Enterprise がデフォルトのランタイムを作成するときは、まずデフォルトのランタイム テンプレートを作成し、デフォルトのランタイムの生成に使用します。ランタイム テンプレートの作成に必要な権限がない状態でデフォルトのランタイムを作成しようとすると、Colab Enterprise はデフォルトのランタイムを作成できません。

この問題を解決するには、aiplatform.notebookRuntimeTemplates.create 権限を含むロールを付与するよう管理者に依頼してください。

次のステップ

• ランタイムとランタイム テンプレートの詳細を確認する。
• ランタイムに接続する。
• ランタイム テンプレートの作成方法を学習する。