ランタイム テンプレートを作成する

ランタイム テンプレートを作成する

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

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

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

ランタイム テンプレートを作成する

ランタイム テンプレートを作成するには、 Google Cloud コンソールまたは Google Cloud CLI を使用します。

コンソール

ランタイム テンプレートを作成するには:

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

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

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

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

ランタイムの基本情報

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

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

3. （省略可）ランタイム テンプレートの説明を追加します。

4. （省略可）ラベルを追加するには、[ ラベルを追加] をクリックして、キーと値のペアを入力します。さらにラベルを追加するには、この手順を繰り返します。

5. [続行] をクリックします。

コンピューティングを構成する

1. [コンピューティングの構成] セクションの [マシンタイプ] メニューで、マシンタイプを選択します。マシンタイプについては、マシン ファミリーのリソースと比較ガイドをご覧ください。

   GPU を搭載したマシンタイプを選択した場合は、アクセラレータ タイプとアクセラレータ数を選択します。必要な GPU 数を選択できない場合は、割り当てを増やす必要がある可能性があります。割り当て増加リクエストを送信するをご覧ください。

2. [ディスクタイプ] メニューで、ディスクタイプを選択します。

3. [ディスクサイズ] フィールドに、サイズを GB 単位で入力します。

4. [アイドル状態でのシャットダウン] セクションで次の設定を行います。

   • アイドル状態のシャットダウンをオフにするには、[アイドル状態でのシャットダウンを有効にする] をオフにします。

   • 非アクティブ時間を変更するには、[シャットダウンまでの非アクティブ時間（分）] で、非アクティブにする時間を変更します。 Google Cloud コンソールでは、この設定を 10 ～ 1440 の任意の整数値に設定できます。

5. [続行] をクリックします。

ネットワークとセキュリティ

1. [ネットワーキングとセキュリティ] セクションの [ネットワーク] メニューで、ネットワークを選択します。ネットワークを選択しない場合は、デフォルト ネットワークが選択されます。

2. [サブネットワーク] メニューで、サブネットワークを選択します。

3. 公共のインターネット アクセスをオフにするには、[公共のインターネット アクセスを有効にする] をオフにします。

4. エンドユーザー認証情報へのアクセスを無効にするには、[エンドユーザー認証情報を有効にする] をオフにします。

ランタイム テンプレートの作成を完了する

[作成] をクリックして、ランタイム テンプレートの作成を完了します。

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

gcloud

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

• DISPLAY_NAME: ランタイム テンプレートの表示名。
• PROJECT_ID: プロジェクト ID。
• REGION: ランタイム テンプレートを配置するリージョン。
• MACHINE_TYPE: ランタイムに使用するマシンタイプ。
• ACCELERATOR_TYPE: ランタイムに使用するハードウェア アクセラレータのタイプ。
• ACCELERATOR_COUNT: ランタイムに使用するアクセラレータの数。

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

Linux、macOS、Cloud Shell

注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。

gcloud colab runtime-templates create --display-name="DISPLAY_NAME" \
    --project=PROJECT_ID \
    --region=REGION \
    --machine-type=MACHINE_TYPE \
    --accelerator-type=ACCELERATOR_TYPE \
    --accelerator-count=ACCELERATOR_COUNT

Windows（PowerShell）

注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。

gcloud colab runtime-templates create --display-name="DISPLAY_NAME" `
    --project=PROJECT_ID `
    --region=REGION `
    --machine-type=MACHINE_TYPE `
    --accelerator-type=ACCELERATOR_TYPE `
    --accelerator-count=ACCELERATOR_COUNT

Windows（cmd.exe）

注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。

gcloud colab runtime-templates create --display-name="DISPLAY_NAME" ^
    --project=PROJECT_ID ^
    --region=REGION ^
    --machine-type=MACHINE_TYPE ^
    --accelerator-type=ACCELERATOR_TYPE ^
    --accelerator-count=ACCELERATOR_COUNT

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

ランタイム テンプレートへのアクセス権の付与

プリンシパルがランタイム テンプレートを使用するには、ランタイム テンプレートを作成した後にそのテンプレートへのアクセス権を付与する必要があります。プリンシパルがランタイム テンプレートからランタイムを作成するには、次の権限が必要です。

• ランタイム テンプレートへのアクセス権。
• ランタイムの作成に必要な権限。

ランタイム テンプレートへのアクセスを管理するをご覧ください。

トラブルシューティング

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

十分な GPU を選択できない

ランタイム テンプレートの作成時に、必要な GPU 数を選択することはできません。これは、割り当てが不足しているためです。

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

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

次のステップ

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