Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

ランタイムとランタイムテンプレート

このページでは、Colab Enterprise のランタイムとランタイムテンプレートについて説明します。

ランタイムは、ノートブック（IPYNB ファイル）内のコードを実行できる、Google がプロビジョニングした仮想マシン（VM）です。

ランタイムテンプレートは、マシンタイプや VM のその他の特徴に加え、ネットワーク、パブリックインターネットアクセスが有効かどうかといった一般的な設定を指定する VM 構成です。ランタイムを作成すると、ランタイムテンプレートの仕様に沿って VM が作成されます。

ワークフロー

Colab Enterprise ノートブックを作成すると、ランタイムについて理解しなくてもノートブック内でコードを実行できるようになります。コードを初めて実行するときに、Colab Enterprise はデフォルトのランタイムをプロビジョニングし、そのランタイム上でコードを実行します。別のランタイムに接続するまで、Colab Enterprise はデフォルトのランタイムを引き続き使用します。

具体的な要件に合わせてランタイムを構成するには、次の操作を行います。

必要な構成でランタイムテンプレートを作成します。
そのテンプレートに基づいてランタイムを作成します。
ノートブックからランタイムに接続してコードを実行します。

ランタイム

このセクションでは、ランタイムの特性について説明します。

デフォルトランタイム

ランタイムを作成しない場合、コードを初めて実行するか、デフォルトのランタイムに初めて接続したときに、アクセラレータのないランタイムが作成されます。アクセラレータなしのデフォルトのランタイムを使用するか、アクセラレータを含むデフォルトのランタイムに切り替えることができます。

プロジェクトとリージョンごとに、アクセラレータなしのデフォルトランタイムとアクセラレータありのデフォルトランタイムを 1 つずつのみ作成できます。

Colab Enterprise がデフォルトのランタイムを作成するときは、プロジェクトのリージョンにデフォルトのランタイムテンプレートがまだ存在しない場合、対応するデフォルトのランタイムテンプレートを最初に作成します。デフォルトのランタイムとランタイムテンプレートの両方が Google Cloud コンソールに表示され、これらの情報を取得できます。

アクセラレータなしのデフォルトのランタイムを使用する場合、Colab Enterprise は、プロジェクトごと、リージョンごとに、アクセラレータなしのデフォルトのランタイムと、対応するランタイムテンプレートを 1 つ作成します（既存のデフォルトのランタイムテンプレートがない場合）。

アクセラレータ付きのデフォルトランタイムを使用する場合、アクセラレータ付きのデフォルトランタイムテンプレートがプロジェクトごと、リージョンごとに存在しない場合、Colab Enterprise はアクセラレータ付きのデフォルトランタイムとその対応するランタイムテンプレートを 1 つ作成します。

デフォルトのランタイム仕様

デフォルトのランタイムと、それに対応して自動的に作成されるデフォルトのランタイムテンプレートには、次の仕様が含まれています。

仕様	デフォルト	デフォルト（GPU 付き）
Python バージョン	利用可能な最新（現在は Python 3.12）	利用可能な最新（現在は Python 3.12）
マシンタイプ	`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 の [ランタイムテンプレート] ページに移動します。

[ランタイムテンプレート] に移動
[リージョン] メニューで、ランタイムテンプレートを含むリージョンを選択します。
デフォルトとして設定するランタイムテンプレートの行で、（アクション）をクリックします。
テンプレートにアクセラレータが含まれているかどうかに応じて、次のようになります。
- アクセラレータのないテンプレートの場合は、[デフォルトに設定] をクリックします。
- アクセラレータを含むテンプレートの場合は、[GPU 使用をデフォルトに設定] をクリックします。
確認ダイアログで、[デフォルトに設定] または [GPU 使用をデフォルトに設定] をクリックして確定します。

ランタイムテンプレートの詳細ページから:

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

[ランタイムテンプレート] に移動
[リージョン] メニューで、ランタイムテンプレートを含むリージョンを選択します。
[ID] 列で、デフォルトとして設定するランタイムテンプレートの ID をクリックします。
ページ上部のアクションバーで、 [デフォルトに設定] または [GPU 使用をデフォルトに設定] をクリックします。
確認ダイアログで、[デフォルトに設定] または [GPU 使用をデフォルトに設定] をクリックして確定します。

Python のバージョン

2025 年 5 月以降、Colab Enterprise がデフォルトのランタイムテンプレートを作成するときに、デフォルトのランタイムテンプレートは最新バージョンの Python（現在は Python 3.12）を使用するように構成されます。つまり、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

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザーアカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

リクエスト本文を 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

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ご自分のユーザーアカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

リクエスト本文を 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

成功した場合、レスポンスの本文には Operation のインスタンスが含まれます。

詳細については、notebookRuntimeTemplates.patch REST API のドキュメントをご覧ください。

サポート対象の Python バージョン

Colab Enterprise は、特定の期間にわたって Python バージョンをサポートします。

次の表に、サポートされている Python の各バージョンのパッチとサポートの終了日と提供終了日を示します。これらの日付の詳細については、サポート終了日についてをご覧ください。

Python バージョン	パッチとサポート終了日	有効期間の終了日
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 つのノートブックのコードが、他のノートブックのランタイムの 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 の設定の「ユーザー認証情報」セクションをご覧ください。

ランタイムテンプレートの料金

ランタイムテンプレートの作成や保存に追加料金はかかりません。ランタイム料金もご覧ください。

次のステップ

ランタイムテンプレートに基づいてランタイムを作成します。
ランタイムに接続する。
ランタイムテンプレートを作成する。