執行階段和執行階段範本

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

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

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

工作流程

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

如要根據特定需求設定執行階段，您必須：

  1. 使用所需設定建立執行階段範本。

  2. 根據該範本建立執行階段。

  3. 透過筆記本連線至執行階段，然後執行程式碼。

執行階段

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

預設執行階段

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

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

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

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

預設執行階段規格

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

規格 預設 預設使用 GPU
Python 版本 最新版本 (目前為 Python 3.11) 最新版本 (目前為 Python 3.11)
機型 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.11)。也就是說，當 Colab Enterprise 提供新版 Python 時，透過預設執行階段範本建立的新執行階段將會使用最新的 Python 版本。

如果預設的執行階段範本是在 2025 年 5 月或更早前建立，可能會設為使用 Python 3.10。如要更新預設執行階段範本，以便使用最新的 Python 版本，您必須刪除預設執行階段範本。接著，在建立新的預設執行階段範本時，系統會將該範本設為使用最新的 Python 版本。

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

即使 Colab Enterprise 提供新的 Python 版本，現有執行階段的 Python 版本也不會自動變更。不支援變更現有執行階段的 Python 版本。您必須使用採用所需 Python 版本的執行階段範本，建立新的執行階段。

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

如要變更執行階段範本的 Python 版本，您可以使用 REST API。

使用任何要求資料之前，請先替換以下項目：

  • 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
如果成功，回應主體會包含 Operation 的例項。

詳情請參閱 notebookRuntimeTemplates.patch REST API 說明文件。

執行階段是區域性

執行階段是區域性質，必須與 Notebook 位於相同區域。

執行階段是專屬於使用者的

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

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

管理執行階段的檔案

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

刪除執行階段時，系統會刪除您上傳的所有檔案。如果您修改了檔案，這些檔案會在建立新的執行階段時還原為原始狀態。請參閱「預設執行階段規格」一節中的自動刪除時間長度。

執行階段可由筆記本共用

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

  • 由於這些程式會共用執行階段的運算資源，因此執行速度可能會變慢。

  • 一個 Notebook 中的程式碼可能會影響另一個 Notebook 的執行階段 VM 狀態。舉例來說，如果您在一個 Notebook 中安裝套件的 1.3 版，但另一個 Notebook 需要 1.2 版，則執行第二個 Notebook 時可能會發生版本不相容的情形。

您可以為每個 Notebook 建立執行階段，而非在同一個執行階段中執行多個 Notebook 的程式碼，請參閱「您可以使用相同的執行階段範本建立多個執行階段」。

執行階段費用

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

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

執行階段關閉時：

  • 由於沒有使用任何 CPU 或 GPU，因此不會產生運算費用。
  • 開機磁碟和資料磁碟的儲存空間會計費。

詳情請參閱 Colab Enterprise 定價。

您可以使用相同的執行階段範本建立多個執行階段

您可以使用單一非預設執行階段範本建立多個執行階段。這樣一來，您就能在具有相同設定的 VM 上執行多個 Notebook，而無須共用該 VM 的資源。

執行階段範本

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

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

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

可與使用者共用執行階段範本

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

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

設定

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

地區

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

機型

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

資料磁碟

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

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

加速器

您可以將加速器新增至執行階段範本設定。加速器的可用性取決於機器類型和區域。

網路

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

閒置關閉

在預設情況下，Colab Enterprise 會啟用閒置關機功能。這個設定會在執行個體閒置 180 分鐘後關閉。您可以變更關機前不活動的時間長度，也可以停用閒置關機功能。

公開網際網路存取權

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

使用者憑證驗證

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

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

執行階段範本費用

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

後續步驟