執行階段和執行階段範本

本頁面說明 Colab Enterprise 的執行階段和執行階段範本。

執行階段是 Google 佈建的虛擬機器 (VM)，可執行筆記本 (IPYNB 檔案) 中的程式碼。

執行階段範本是 VM 設定，可指定 VM 的機器類型和其他特徵，以及網路和是否啟用公開網際網路存取權等常見設定。建立執行階段時，系統會根據執行階段範本的規格建立 VM。

工作流程

您可以建立 Colab Enterprise 筆記本並在其中執行程式碼，不必瞭解執行階段。首次執行程式碼時，Colab Enterprise 會佈建預設執行階段，並在該階段執行程式碼。在連線至其他執行階段之前，Colab Enterprise 會繼續使用預設執行階段。

如要根據特定需求設定執行階段，請完成下列步驟：

使用所需設定建立執行階段範本。
依據該範本建立執行階段。
從筆記本連線至執行階段，然後執行程式碼。

執行階段

本節說明執行階段的特性。

預設執行階段

如果您未建立執行階段，系統會在您首次執行程式碼或連線至預設執行階段時，為您建立不含加速器的執行階段。你可以使用不含加速器的預設執行階段，也可以切換至含加速器的預設執行階段。

Colab Enterprise 建立預設執行階段時，會先建立對應的預設執行階段範本。執行階段和執行階段範本都會顯示在 Google Cloud 控制台中，您可以在這裡取得相關資訊。

如果您使用沒有加速器的預設執行階段，Colab Enterprise 會為每個專案和區域建立一個沒有加速器的預設執行階段，以及對應的執行階段範本。

如果您使用含加速器的預設執行階段，Colab Enterprise 會為每個專案和每個區域，建立一個含加速器的預設執行階段，以及對應的執行階段範本。

預設執行階段規格

預設執行階段及其對應的預設執行階段範本包含下列規格：

規格	預設	預設 (使用 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 分鐘
網路	專案的預設虛擬私有雲網路	專案的預設虛擬私有雲網路
公開網際網路存取權	已啟用	已啟用
使用者憑證驗證	已啟用	已啟用
自動刪除	建立後 18 小時自動刪除	建立後 18 小時自動刪除

Python 版本

自 2025 年 5 月起，Colab Enterprise 建立預設執行階段範本時，會將預設執行階段範本設為使用最新版 Python (目前為 Python 3.12)。也就是說，當 Colab Enterprise 推出新版 Python 時，以預設執行階段範本建立的新執行階段會使用最新版 Python。

如果預設執行階段範本是在 2025 年 5 月或之前建立，可能已設為使用 Python 3.10。如要更新預設執行階段範本，以使用最新 Python 版本，請刪除預設執行階段範本。這樣一來，系統建立新的預設執行階段範本時，就會將其設為使用最新 Python 版本。

如要更新所建立執行階段範本的 Python 版本，請參閱「變更執行階段範本的 Python 版本」。

即使 Colab Enterprise 推出新的 Python 版本，現有執行階段的 Python 版本也不會自動變更。不支援變更現有執行階段的 Python 版本。而是必須從使用所需 Python 版本的執行階段範本，衍生出新的執行階段。

變更執行階段範本的 Python 版本

如要變更執行階段範本的 Python 版本，可以使用 Google Cloud 控制台或 REST API。

控制台

如要編輯執行階段範本，請按照下列步驟操作：

前往 Google Cloud 控制台的 Colab Enterprise「執行階段範本」頁面。

前往「執行階段範本」
在「Region」(地區) 選單中，選取包含執行階段範本的地區。
在「ID」欄中，按一下要編輯的執行階段範本 ID 號碼。
按一下「編輯」圖示。
在「編輯執行階段範本」面板中，變更執行階段範本。
按一下「Update」。

REST

使用任何要求資料之前，請先修改下列項目的值：

REGION：執行階段範本所在的區域。
PROJECT_ID：您的專案 ID。
NOTEBOOK_RUNTIME_TEMPLATE_ID：執行階段範本的 ID。
RELEASE_NAME：要使用的映像檔發布名稱。舉例來說，Python 3.11 映像檔的發布名稱為 py311。如要將圖片設為 Latest，請將 RELEASE_NAME 留空。

HTTP 方法和網址：

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 版本。
- 現有的執行階段無法再升級。
- 執行階段在最近一次升級後六個月會停止運作，如果未升級，則會在建立後六個月停止運作。
如要申請延長使用這個 Python 版本的期限，請在支援期限結束前與帳戶代表聯絡 Google Cloud。
供應期限：此日期過後，將發生下列變化：
- 即使是獲得延期的使用者，也無法在 Colab Enterprise 中使用這個 Python 版本。
- 使用這個 Python 版本的現有執行階段範本，會自動升級為使用最新可用的 Python 版本。

執行階段是區域資源

執行階段是區域性的，必須與筆記本位於相同區域。

執行階段專屬於使用者

執行階段專屬於使用者。您無法與他人共用執行階段，也無法使用對方的執行階段。即使你與他人共用筆記本，對方也無法存取你的執行階段，必須在自己的執行階段中執行筆記本。

不過，使用者可以根據相同的執行階段範本建立自己的執行階段。請參閱「可與使用者共用執行階段範本」。

管理執行階段的檔案

在 Colab Enterprise 中，您可以按一下「檔案」按鈕，存取及修改執行階段中的檔案。您也可以將檔案上傳至執行階段。

刪除執行階段時，您上傳的任何檔案都會一併刪除。如果您修改過檔案，建立新的執行階段時，這些檔案會還原為原始狀態。在「預設執行階段規格」部分查看自動刪除時間範圍。

筆記本可以共用執行階段

您可以將多個筆記本連線至同一個執行階段，但我們不建議這麼做。多個筆記本共用同一個執行階段可能會導致問題，包括：

筆記本共用執行階段的運算資源，因此執行速度可能會較慢。
一個筆記本中的程式碼可能會影響其他筆記本的執行階段 VM 狀態。舉例來說，如果您在一個筆記本中安裝套件 1.3 版，但另一個筆記本需要 1.2 版，執行第二個筆記本時可能會發生版本不相容的問題。

您不必在同一個執行階段中執行多個筆記本的程式碼，而是可以根據相同的執行階段範本，為每個筆記本建立執行階段。請參閱「您可以從同一個執行階段範本建立多個執行階段」。

執行階段費用

系統會根據您使用的機器類型和加速器，收取執行階段處理費用。系統也會針對開機磁碟和資料磁碟儲存空間向您收取費用。刪除執行階段時，系統會一併刪除開機磁碟和資料磁碟。

除了執行階段範本中指定的資料磁碟之外，執行階段一律也會包含 100 GiB SSD 永久磁碟。開機磁碟無法設定。

執行階段關閉期間：

由於沒有 CPU 或 GPU 用量，因此不會產生運算費用。
系統會針對開機磁碟和資料磁碟儲存空間收費。

詳情請參閱 Colab Enterprise 定價。

您可以從同一個執行階段範本建立多個執行階段

您可以從單一非預設執行階段範本建立多個執行階段。這樣一來，您就能在 VM 上執行多個筆記本，且這些 VM 具有相同設定，不必共用 VM 的資源。

執行階段範本

本節說明執行階段範本的特性。

執行階段範本適用於特定地區

執行階段範本是區域性範本。建立執行階段時，執行階段會與執行階段範本位於相同區域，且執行階段只能與該區域的筆記本搭配使用。

您可以與其他使用者共用執行階段範本，這樣一來，每位使用者都能根據相同的執行階段範本建立自己的執行階段，因此多位使用者可以在相同的 VM 設定上執行相同的筆記本。

詳情請參閱「管理執行階段範本的存取權」。

設定

執行階段範本會決定執行階段 VM 的設定。您可以指定下列任一項：

區域

選擇筆記本所在的區域。從執行階段範本建立的執行階段，與執行階段範本位於相同區域。如要讓筆記本在執行階段中執行程式碼，筆記本和執行階段必須位於相同區域。

機型

您可以設定執行階段範本的機器類型。如要瞭解機器類型，請參閱機器系列資源和比較指南。

資料磁碟

您可以在執行階段範本中設定資料磁碟的磁碟類型和磁碟大小。

建立執行階段時，系統也會一併建立開機磁碟。開機磁碟是 100 GiB 的 SSD 永久磁碟，無法設定。

加速器

您可以在執行階段範本設定中新增加速器。加速器供應情形取決於機器類型和區域。

網路

指定網路或使用專案的預設虛擬私有雲網路。

閒置關閉

Colab Enterprise 預設會啟用閒置關機功能。這項設定會在閒置 180 分鐘後關閉執行個體。你可以變更關機前的閒置時間 (以分鐘為單位)，也可以停用閒置關機功能。

公開網際網路存取權

如要進一步控管筆記本和其他資源的安全性，可以關閉公開網際網路存取權。如果您以這種方式設定執行階段範本，使用從執行階段範本建立的執行階段的筆記本，就無法存取公開網際網路。

使用者憑證驗證

根據預設，執行階段範本會使用使用者憑證驗證，讓筆記本存取應用程式預設憑證 (ADC)。您可以使用這個 ADC 存取權，在筆記本中執行與 Vertex AI 和其他 Google Cloud 服務互動的程式碼。啟用使用者憑證後，筆記本會使用執行筆記本的使用者憑證，判斷資源的存取權。 Google Cloud

如果未啟用使用者憑證，您可以透過筆記本的程式碼驗證使用者，取得 ADC 存取權。詳情請參閱「為本機開發環境設定 ADC」一文的「使用者憑證」一節。

執行階段範本費用

建立或儲存執行階段範本不會產生費用。另請參閱「執行階段費用」。