本頁面由 Cloud Translation API 翻譯而成。

執行階段和執行階段範本

本頁面說明 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 版本，可以使用 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

注意：下列指令假設您已執行 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 說明文件。

執行階段是區域資源

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

執行階段專屬於使用者

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

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

管理執行階段的檔案

在 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」的「使用者憑證」一節。

執行階段範本費用

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