執行階段和執行階段範本
本頁面說明 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 版本，請參閱「管理執行階段範本」。
即使 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：要使用的映像檔發布名稱。 舉例來說，py311是 Python 3.11 映像檔的發布名稱。如要將圖片設為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
將要求主體儲存在名為 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
支援的 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 存取權，在筆記本中執行與 Agent Platform 和其他 Google Cloud 服務互動的程式碼。啟用使用者憑證後，筆記本會使用執行筆記本的使用者憑證，判斷資源的存取權 Google Cloud 。
如果未啟用使用者憑證，您可以透過筆記本的程式碼驗證使用者，藉此存取 ADC。詳情請參閱「為本機開發環境設定 ADC」一文的「使用者憑證」一節。
執行階段範本費用
建立或儲存執行階段範本不會產生費用。另請參閱執行階段費用。