ランタイムとランタイム テンプレート
このページでは、Colab Enterprise のランタイムとランタイム テンプレートについて説明します。
ランタイムは、ノートブック(IPYNB ファイル)内でコードを実行できる、Google がプロビジョニングした仮想マシン(VM)です。
ランタイム テンプレートは、マシンタイプや VM のその他の特徴に加え、ネットワーク、パブリック インターネット アクセスが有効かどうかといった一般的な設定を指定する VM 構成です。ランタイムを作成すると、ランタイム テンプレートの仕様に沿って VM が作成されます。
ワークフロー
Colab Enterprise ノートブックを作成すると、ランタイムについて理解しなくてもノートブック内でコードを実行できるようになります。コードを初めて実行するときに Colab Enterprise からデフォルトのランタイムがプロビジョニングされ、そのランタイム上でコードが実行されます。Colab Enterprise は、別のランタイムに接続するまで、デフォルトのランタイムを引き続き使用します。
具体的な要件に合わせてランタイムを構成するには、どうすればよいですか。
必要な構成でランタイム テンプレートを作成します。
そのテンプレートに基づいてランタイムを作成します。
ノートブックからランタイムに接続してコードを実行します。
ランタイム
このセクションでは、ランタイムの特性について説明します。
デフォルト ランタイム
ランタイムを作成しない場合、コードを初めて実行するか、デフォルトのランタイムに接続するときに、アクセラレータのないランタイムが作成されます。アクセラレータなしのデフォルトのランタイムを使用することも、アクセラレータを含むデフォルトのランタイムに切り替えることもできます。
プロジェクトごと、リージョンごとに、ユーザーごとにアクセラレータなしのデフォルト ランタイム 1 つと、アクセラレータありのデフォルト ランタイム 1 つのみが許可されます。
Colab Enterprise がデフォルトのランタイムを作成するときに、プロジェクトにそのリージョンのデフォルトのランタイム テンプレートがまだない場合は、まず対応するデフォルトのランタイム テンプレートを作成します。デフォルトのランタイムとランタイム テンプレートはどちらも Google Cloud コンソールに表示され、そこで情報を取得できます。
アクセラレータなしのデフォルト ランタイムを使用する場合、Colab Enterprise は、アクセラレータなしのデフォルト ランタイムを 1 つ作成します。また、既存のデフォルト ランタイム テンプレートがない場合は、プロジェクトごと、リージョンごとに、対応するランタイム テンプレートを作成します。
アクセラレータ付きのデフォルト ランタイムを使用する場合、Colab Enterprise は、アクセラレータ付きのデフォルト ランタイム テンプレートがプロジェクトごと、リージョンごとに存在しない場合、アクセラレータ付きのデフォルト ランタイムと、それに対応するランタイム テンプレートを 1 つ作成します。
デフォルトのランタイム仕様
デフォルトのランタイムと、それに対応する自動作成されたデフォルトのランタイム テンプレートには、次の仕様が含まれています。
| 仕様 | デフォルト | デフォルト(GPU 付き) |
|---|---|---|
| Python バージョン | 利用可能な最新バージョン(現在は Python 3.13) | 利用可能な最新バージョン(現在は Python 3.13) |
| マシンタイプ | e2-standard-4 |
地域によって異なります。仕様をご覧ください。 |
| アクセラレータ | なし | 地域によって異なります。仕様をご覧ください。 |
| ブートディスク | 100 GiB SSD 永続ディスク(pd-ssd) |
100 GiB SSD 永続ディスク(pd-ssd) |
| データディスク | 100 GiB の標準永続ディスク(pd-standard) |
地域によって異なります。仕様をご覧ください。 |
| アイドル状態でのシャットダウン | 有効、180 分に設定 | 有効、180 分に設定 |
| ネットワーク | プロジェクトのデフォルトの Virtual Private Cloud ネットワーク | プロジェクトのデフォルトの Virtual Private Cloud ネットワーク |
| 公共のインターネット アクセス | 有効 | 有効 |
| エンドユーザー認証情報の認証 | 有効 | 有効 |
| 自動削除 | 作成から 18 時間後に自動削除 | 作成から 18 時間後に自動削除 |
ランタイム テンプレートをデフォルトのランタイム テンプレートとして設定する
既存のランタイム テンプレートを、プロジェクトとリージョンのデフォルトのランタイム テンプレートとして設定できます。ランタイム テンプレートをデフォルトとして設定すると、現在のプロジェクトとリージョンで作成された新しいデフォルト ランタイムは、そのテンプレートの構成を使用します。既存のランタイムは影響を受けません。
ランタイム テンプレートがデフォルトのランタイム テンプレートとして設定されると、デフォルトのランタイム テンプレートから作成された新しいランタイムはすべて、作成から 18 時間後に自動的に削除されます。
リージョンとプロジェクトの組み合わせごとに、アクセラレータなしのデフォルトのランタイム テンプレートと、アクセラレータありのデフォルトのランタイム テンプレートを 1 つずつ作成できます。以前にデフォルト テンプレートだったランタイム テンプレートはユーザー定義テンプレートになり、それらから作成された新しいランタイムは 6 か月後に自動的に削除されます。
アクセラレータなしのデフォルトのランタイム テンプレートと、アクセラレータありのデフォルトのランタイム テンプレートの両方を設定できます。
ランタイム テンプレートをデフォルトのランタイム テンプレートとして設定するには、Google Cloud コンソールを使用します。これは、[ランタイム テンプレート] ページまたはランタイム テンプレートの詳細ページから行うことができます。
[ランタイム テンプレート] ページから:
Google Cloud コンソールで、Colab Enterprise の [ランタイム テンプレート] ページに移動します。
[リージョン] メニューで、ランタイム テンプレートを含むリージョンを選択します。
デフォルトとして設定するランタイム テンプレートの行で、 [アクション] をクリックします。
テンプレートにアクセラレータが含まれているかどうかによって、次のようになります。
- アクセラレータのないテンプレートの場合は、[デフォルトに設定] をクリックします。
- アクセラレータを含むテンプレートの場合は、[Set as Default with GPU] をクリックします。
確認ダイアログで、[デフォルトに設定] または [GPU 使用をデフォルトに設定] をクリックして確定します。
ランタイム テンプレートの詳細ページから削除する:
Google Cloud コンソールで、Colab Enterprise の [ランタイム テンプレート] ページに移動します。
[リージョン] メニューで、ランタイム テンプレートを含むリージョンを選択します。
[ID] 列で、デフォルトとして設定するランタイム テンプレートの ID をクリックします。
ページ上部のアクションバーで、 [デフォルトに設定] または [GPU 使用をデフォルトに設定] をクリックします。
確認ダイアログで、[デフォルトに設定] または [GPU 使用をデフォルトに設定] をクリックして確定します。
Python のバージョン
Colab Enterprise がデフォルトのランタイム テンプレートを作成するとき、デフォルトのランタイム テンプレートは、利用可能な最新バージョンの Python(現在は Python 3.13)を使用するように構成されます。つまり、Colab Enterprise で新しいバージョンの Python が利用可能になると、デフォルトのランタイム テンプレートから作成された新しいランタイムは最新の Python バージョンを使用します。
デフォルトのランタイム テンプレートが 2025 年 5 月以前に作成された場合、Python 3.10 を使用するように構成されている可能性があります。最新の Python バージョンを使用するようにデフォルトのランタイム テンプレートを更新するには、デフォルトのランタイム テンプレートを削除する必要があります。新しいデフォルトのランタイム テンプレートが作成されると、最新の Python バージョンを使用するように構成されます。
作成したランタイム テンプレートの Python バージョンを更新するには、ランタイム テンプレートを管理するをご覧ください。
Colab Enterprise で新しい Python バージョンが利用可能になっても、既存のランタイムの Python バージョンは自動的に変更されません。既存のランタイムの Python バージョンの変更はサポートされていません。代わりに、必要な Python バージョンを使用するランタイム テンプレートから派生した新しいランタイムを作成する必要があります。
ランタイム テンプレートの Python バージョンを変更する
ランタイム テンプレートの Python バージョンを変更するには、 Google Cloud コンソールまたは REST API を使用します。
コンソール
ランタイム テンプレートを編集する手順は次のとおりです。
-
Google Cloud コンソールで、Colab Enterprise の [ランタイム テンプレート] ページに移動します。
-
[リージョン] メニューで、ランタイム テンプレートを含むリージョンを選択します。
-
[ID] 列で、編集するランタイム テンプレートの ID 番号をクリックします。
-
[ 編集] をクリックします。
-
[ランタイム テンプレートの編集] パネルで、ランタイム テンプレートを変更します。
-
[更新] をクリックします。
REST
リクエストのデータを使用する前に、次のように置き換えます。
REGION: ランタイム テンプレートが配置されているリージョン。PROJECT_ID: プロジェクト ID。NOTEBOOK_RUNTIME_TEMPLATE_ID: ランタイム テンプレートの ID。RELEASE_NAME: 使用するイメージのリリース名。たとえば、py311は Python 3.11 イメージのリリース名です。イメージをLatestに設定するには、RELEASE_NAMEを空のままにします。
HTTP メソッドと URL:
PATCH https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name
リクエストの本文(JSON):
{
softwareConfig: {
colabImage: {
releaseName: "RELEASE_NAME"
}
}
}
リクエストを送信するには、次のいずれかのオプションを選択します。
curl
リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name"
PowerShell
リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name" | Select-Object -Expand Content
詳しくは、notebookRuntimeTemplates.patch REST API のドキュメントをご覧ください。
サポート対象の Python バージョン
Colab Enterprise は、特定の期間にわたって Python バージョンをサポートします。
次の表に、サポートされている Python の各バージョンのパッチとサポートの終了日と提供終了日を示します。これらの日付の詳細については、サポート終了日についてをご覧ください。
| Python バージョン | パッチとサポート終了日 | 有効期間の終了日 |
|---|---|---|
| Python 3.13 | 未定 | 未定 |
| Python 3.12 | 未定 | 未定 |
| Python 3.11 | 未定 | 未定 |
| Python 3.10 | 2026 年 2 月 23 日 | 2026 年 8 月 17 日 |
サポート終了日について
Python バージョンのサポートは、次の日付で終了します。
パッチとサポートの終了日: この日付以降、次の変更が行われます。
- この Python バージョンを使用するランタイム テンプレートは作成できません。
- この Python バージョンを使用する既存のランタイム テンプレートは、利用可能な最新の Python バージョンを使用するように自動的にアップグレードされます。
- 既存のランタイムはアップグレードできなくなりました。
- ランタイムは、最新のアップグレードから 6 か月後、またはアップグレードされていない場合は作成から 6 か月後に機能しなくなります。
この Python バージョンの使用を有効期限まで延長することをリクエストするには、 Google Cloudアカウント担当者にお問い合わせください。
入荷予定日の終了日: この日付以降、次の変更が行われます。
- この Python バージョンは、拡張機能が付与されているユーザーであっても、Colab Enterprise では使用できません。
- この Python バージョンを使用する既存のランタイム テンプレートは、利用可能な最新の Python バージョンを使用するように自動的にアップグレードされます。
ランタイムはリージョンに属している
ランタイムはリージョンに固有であり、ノートブックと同じリージョンに配置する必要があります。
ランタイムはユーザー専用です
ランタイムはユーザー専用です。ランタイムを他のユーザーと共有することはできません。また、他のユーザーのランタイムを使用することもできません。ノートブックを他のユーザーと共有しても、そのユーザーはランタイムにアクセスできません。ノートブックは独自のランタイムで実行する必要があります。
ただし、ユーザーは同じランタイム テンプレートに基づいて独自のランタイムを作成できます。ランタイム テンプレートをユーザーと共有できるをご覧ください。
ランタイムのファイルの管理
ランタイム上のファイルにアクセスして変更するには、Colab Enterprise の [ファイル] ボタンを使用します。ランタイムにファイルをアップロードすることもできます。
ランタイムが削除されると、アップロードしたファイルも削除されます。ファイルを変更した場合、新しいランタイムが作成されると、それらのファイルは元の状態に戻ります。[デフォルトのランタイム仕様] セクションで、自動削除の期間を確認します。
ランタイムはノートブックで共有できる
複数のノートブックを同じランタイムに接続できますが、これはおすすめしません。複数のノートブックで同じランタイムを共有すると、次のような問題が発生する可能性があります。
ノートブックはランタイムのコンピューティング リソースを共有しているため、実行速度が遅くなることがあります。
1 つのノートブックのコードが、もう 1 つのノートブックのランタイムの VM の状態に影響する可能性があります。たとえば、あるノートブックにパッケージのバージョン 1.3 をインストールし、別のノートブックでバージョン 1.2 が必要な場合、2 番目のノートブックを実行するとバージョンの非互換性が発生する可能性があります。
同じランタイムで複数のノートブックからコードを実行する代わりに、同じランタイム テンプレートに基づいてノートブックごとにランタイムを作成できます。同じランタイム テンプレートから複数のランタイムを作成できるをご覧ください。
ランタイム料金
ランタイム処理の料金は、使用するマシンタイプとアクセラレータに基づいて請求されます。また、ブートディスクとデータディスクのストレージに対しても課金されます。ブートディスクとデータディスクは、ランタイムが削除されると削除されます。
ランタイムには、ランタイム テンプレートで指定されたデータディスクに加えて、常に 100 GiB の SSD 永続ディスクが含まれます。このブートディスクは構成を変更できません。
ランタイムがシャットダウンされている間は、次のようになります。
- CPU や GPU の使用量がないため、コンピューティング料金は発生しません。
- ブートディスクとデータディスクのストレージは課金されます。
詳細については、Colab Enterprise の料金をご覧ください。
同じランタイム テンプレートから複数のランタイムを作成できます。
デフォルト以外の単一のランタイム テンプレートから複数のランタイムを作成できます。これにより、その VM のリソースを共有することなく、同じ構成の VM で複数のノートブックを実行できます。
ランタイム テンプレート
このセクションでは、ランタイム テンプレートの特性について説明します。
ランタイム テンプレートはリージョン リソースです
ランタイム テンプレートはリージョン リソースです。ランタイムを作成すると、ランタイム テンプレートと同じリージョンに作成されます。ランタイムは、そのリージョンのノートブックでのみ使用できます。
ランタイム テンプレートはユーザーと共有できます
ランタイム テンプレートを他のユーザーと共有できます。これにより、各ユーザーは同じランタイム テンプレートに基づいて独自のランタイムを作成できるため、複数のユーザーが同じ VM 構成で同じノートブックを実行できます。
詳細については、ランタイム テンプレートへのアクセスを管理するをご覧ください。
構成
ランタイム テンプレートは、ランタイムの VM の構成を決定します。次のいずれかを指定できます。
リージョン
ノートブックがあるリージョンを選択します。ランタイム テンプレートから作成されたランタイムは、ランタイム テンプレートと同じリージョンにあります。ノートブックがランタイムでコードを実行するには、ノートブックとランタイムが同じリージョンに存在する必要があります。
マシンタイプ
ランタイム テンプレートのマシンタイプを構成できます。マシンタイプについては、マシン ファミリーのリソースと比較ガイドをご覧ください。
データディスク
ランタイム テンプレートで、データディスクのディスクタイプとディスクサイズを構成できます。
ランタイムを作成すると、ブートディスクも含まれます。ブートディスクは 100 GiB の SSD 永続ディスクであり、構成できません。
アクセラレータ
ランタイム テンプレートの構成にアクセラレータを追加できます。アクセラレータの可用性は、マシンタイプとリージョンによって異なります。
ネットワーク
ネットワークを指定するか、プロジェクトのデフォルトの Virtual Private Cloud ネットワークを使用します。
アイドル状態でのシャットダウン
Colab Enterprise では、アイドル シャットダウンがデフォルトで有効になっています。この設定では、180 分間操作がないとインスタンスがシャットダウンされます。シャットダウンまでの非アクティブ時間(分)を変更できます。また、アイドル状態でのシャットダウンを無効にすることもできます。
公共のインターネット アクセス
ノートブックやその他のリソースのセキュリティをより細かく制御するには、パブリック インターネット アクセスをオフにします。この方法でランタイム テンプレートを構成すると、ランタイム テンプレートから作成されたランタイムを使用するノートブックは、パブリック インターネットにアクセスできなくなります。
エンドユーザー認証情報の認証
デフォルトでは、ランタイム テンプレートはエンドユーザー認証情報認証を使用して、ノートブックにアプリケーションのデフォルト認証情報(ADC)へのアクセス権を付与します。この ADC へのアクセスを使用して、Agent Platform や他の Google Cloud サービスとやり取りするコードをノートブックで実行できます。エンドユーザー認証情報が有効になっている場合、ノートブックはノートブックを実行するユーザーの認証情報を使用して、 Google Cloud リソースへのアクセスを決定します。
エンドユーザー認証情報が有効になっていない場合は、ノートブックのコードでユーザーを認証することで ADC にアクセスできます。詳細については、ローカル開発環境の ADC を設定するの「ユーザー認証情報」セクションをご覧ください。
ランタイム テンプレートの料金
ランタイム テンプレートの作成や保存に料金はかかりません。ランタイム料金もご覧ください。
次のステップ
- ランタイム テンプレートに基づいてランタイムを作成します。
- ランタイムに接続する。
- ランタイム テンプレートを作成する。