Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

執行階段和執行階段範本

本頁面說明 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 小時自動刪除

將執行階段範本設為預設執行階段範本

您可以將現有的執行階段範本設為專案和區域的預設執行階段範本。將執行階段範本設為預設值後，在目前的專案和區域中建立新的預設執行階段時，就會使用該範本的設定。現有執行階段不受影響。

將執行階段範本設為預設執行階段範本後，系統會在透過預設執行階段範本建立新執行階段的 18 小時後，自動刪除這些執行階段。

每個區域和專案組合只能有一個不含加速器的預設執行階段範本，以及一個含加速器的預設執行階段範本。先前為預設範本的執行階段範本會變成使用者定義範本，而從這些範本建立的新執行階段會在 6 個月後自動刪除。

您可以設定不含加速器的預設執行階段範本，以及含加速器的預設執行階段範本。

這項權限包含在「Colab Enterprise 管理員」 (roles/aiplatform.colabEnterpriseAdmin) 和「筆記本執行階段管理員」 (roles/aiplatform.notebookRuntimeAdmin) 等角色中。

如要將執行階段範本設為預設範本，可以使用Google Cloud 控制台。您可以透過「執行階段範本」頁面或執行階段範本的詳細資料頁面執行這項操作。

從執行階段範本頁面：

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

前往「執行階段範本」
在「Region」(區域) 選單中，選取包含執行階段範本的區域。
在要設為預設的執行階段範本列中，按一下「動作」。
視範本是否包含加速器而定：
- 如果範本沒有快速鍵，請按一下「設為預設值」。
- 如要將含有加速器的範本設為預設範本，請按一下「設為預設範本 (有 GPU)」。
在確認對話方塊中，按一下「設為預設範本」或「設為預設範本 (有 GPU)」進行確認。

從執行階段範本詳細資料頁面：

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

前往「執行階段範本」
在「Region」(區域) 選單中，選取包含執行階段範本的區域。
在「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「執行階段範本」頁面。

前往「執行階段範本」
在「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

注意：下列指令假設您已執行 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 版本。
- 現有執行階段無法再升級。
- 執行階段會在最近一次升級後六個月停止運作，如果未升級，則會在建立後六個月停止運作。
如要申請延長使用期限，請在支援期限結束前與帳戶代表聯絡 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」的「使用者憑證」一節。

執行階段範本費用

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