予約を使用する

予約を使用する

Private preview

This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

For information about access to this release, see the access request page.

Colab Enterprise ランタイムで VM リソースが必要なときに利用できるようにするには、Compute Engine の予約を使用します。予約を使用すると、Compute Engine ゾーンリソースのキャパシティを確実に確保できます。

概要

Colab Enterprise で予約を使用するには、次のタスクを実行します。

1. 予約を作成します。

2. 予約を新しいランタイム テンプレートに追加します。

3. ランタイム テンプレートから派生したランタイムでコードを実行して、予約を使用する。

制限事項と要件

Colab Enterprise ランタイムが予約を使用すると、Compute Engine の予約のすべての制限が適用されます。詳細については、予約の仕組みをご覧ください。

また、Colab Enterprise で予約を使用する場合は、次の制限と要件が適用されます。

• Colab Enterprise の予約は限定公開プレビューです。アクセスをリクエストするには、アクセス リクエスト ページをご覧ください。

• 確約利用割引は適用されません。

• 予約は、Colab Enterprise ノートブックとランタイムと同じプロジェクトに存在する必要があります。

• 予約のマシンタイプは、ランタイム テンプレートのマシンタイプと一致している必要があります。

始める前に

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 で予約を使用するのに必要な権限がユーザー アカウントに付与されるように、プロジェクトに対する次の IAM ロールをユーザー アカウントに付与するよう管理者に依頼してください。

• Colab Enterprise ユーザー （roles/aiplatform.colabEnterpriseUser）
• Compute 管理者（roles/compute.admin）

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

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

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

予約を作成する

Compute Engine の予約を作成します。単一のプロジェクト予約にすることも、共有予約にすることもできます。詳細については、次のドキュメントをご覧ください。

• 単一プロジェクトの予約を作成する
• 共有予約を作成する

この予約に GPU アクセラレータを含めることができます。

新しいランタイム テンプレートに予約を追加する

予約を使用するランタイム テンプレートを作成する手順は次のとおりです。

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

   [ランタイム テンプレート] に移動

2. [ 新しいテンプレート] をクリックします。

   [ランタイム テンプレートの新規作成] ダイアログが表示されます。

3. [ランタイムの基本情報] セクションで表示名を入力します。

4. [リージョン] メニューで、ランタイム テンプレートを配置するリージョンを選択します。

5. [コンピューティングの構成] セクションの [マシンタイプ] メニューで、マシンタイプを選択します。ランタイム テンプレートのマシンタイプは、予約のマシンタイプと一致する必要があります。

   予約とランタイム テンプレートのマシンタイプが一致しない場合、Colab Enterprise はこのランタイム テンプレートからランタイムを作成できません。

6. [予約] メニューで、使用する特定の予約を選択するか、[自動的に選択された予約を使用する] を選択します。

   自動的に選択された予約または特定の予約の使用について詳しくは、予約の仕組みの使用タイプをご覧ください。

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

   ランタイム テンプレートが [ランタイム テンプレート] タブのリストに表示されます。

予約を使用する

予約を使用する手順は次のとおりです。

1. 新しいランタイム テンプレートからランタイムを作成します。

2. ノートブックを開くか、作成します。

3. ノートブックでランタイムに接続し、コードを実行します。

予約の使用を停止する

予約の使用を停止するには、予約を削除します。

他のリソースで予約を引き続き使用し、Colab Enterprise ノートブックで予約を使用しない場合は、予約に関連付けられているランタイムとランタイム テンプレートを削除します。

課金

予約済みの Compute Engine VM リソースは、Colab Enterprise ランタイムの実行中に Colab Enterprise によって課金され、Colab Enterprise で VM リソースが使用されていない場合は Compute Engine によって課金されます。

トラブルシューティング

このセクションでは、Colab Enterprise で予約を使用する際の問題を解決する方法について説明します。

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

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

Failed to create notebook runtime with error: Invalid value for field
'resource.reservationAffinity': '{"consumeReservationType":
"SPECIFIC_ALLOCATION", "key": "compute.googleapis.com/reservation-name...'.
No available resources in specified reservations.

このエラーは、ランタイム テンプレートと予約のマシンタイプが一致しない場合に発生します。

この問題を解決するには、予約のマシンタイプと一致するマシンタイプを使用してランタイム テンプレートを作成します。

次のステップ

• プリンシパルにランタイム テンプレートへのアクセス権を付与するには、ランタイム テンプレートへのアクセスを管理するをご覧ください。

• Compute Engine の予約の詳細については、Compute Engine ゾーンリソースの予約をご覧ください。