Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

运行时和运行时模板

本页面介绍了 Colab Enterprise 的运行时和运行时模板。

运行时是由 Google 预配的虚拟机 (VM)，可运行笔记本（IPYNB 文件）中的代码。

运行时模板是一种虚拟机配置，用于指定虚拟机的机器类型和其他特征，以及网络和是否启用公共互联网访问权限等常见设置。创建运行时时，系统会根据运行时模板的规范创建该运行时的虚拟机。

工作流

您可以创建 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 个月后自动删除。

您可以同时设置不含加速器的默认运行时模板和含加速器的默认运行时模板。

如需将某个运行时模板设置为默认运行时模板，您可以使用Google Cloud 控制台。您可以在运行时模板页面或运行时模板的详情页面中执行此操作。

在运行时模板页面中：

在 Google Cloud 控制台中，前往 Colab Enterprise 运行时模板页面。

进入运行时模板
在区域菜单中，选择包含运行时模板的区域。
在要设为默认的运行时模板所在的行中，点击操作。
具体取决于模板是否包含加速器：
- 对于没有加速器的模板，请点击设为默认。
- 对于包含加速器的模板，请点击设为默认项（带 GPU）。
在确认对话框中，点击设为默认或设为默认项（带 GPU）以进行确认。

在运行时模板详情页面中：

在 Google Cloud 控制台中，前往 Colab Enterprise 运行时模板页面。

进入运行时模板
在区域菜单中，选择包含运行时模板的区域。
在 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 运行时模板页面。

进入运行时模板
在区域菜单中，选择包含运行时模板的区域。
在 ID 列中，点击要修改的运行时模板的 ID 编号。
点击修改。
在修改运行时模板面板中，对运行时模板进行更改。
点击更新。

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 版本。
- 现有运行时不再可升级。
- 运行时在最近一次升级后的 6 个月内停止运行，如果未升级，则在创建后的 6 个月内停止运行。
如需申请将此 Python 版本的可用期延长至结束日期，请与您的 Google Cloud客户代表联系。
发货日期终止：在此日期之后，会发生以下变化：
- 即使是获得延期的用户，也无法在 Colab Enterprise 中使用此 Python 版本。
- 使用此 Python 版本的任何现有运行时模板都会自动升级为使用最新的可用 Python 版本。

运行时是区域级的

运行时是区域性的，必须与笔记本位于同一区域。

运行时专供用户使用

运行时专供用户使用。您无法与他人分享自己的跑步时段，也无法使用他人的跑步时段。即使您与他人共享笔记本，对方也无权访问您的运行时，必须在自己的运行时中运行笔记本。

不过，用户可以基于同一运行时模板创建自己的运行时。请参阅运行时模板可与用户共享。

管理运行时文件

您可以在 Colab Enterprise 中使用文件按钮访问和修改运行时中的文件。您还可以将文件上传到运行时。

删除运行时后，您上传的所有文件也会一并删除。如果您修改了文件，那么在创建新的运行时时，这些文件将恢复到其原始状态。在默认运行时规范部分中查看自动删除时间段。

运行时可由笔记本共享

您可以将多个笔记本连接到同一运行时，但不建议这样做。多个笔记本共享同一个运行时可能会导致问题，包括：

由于笔记本共享了运行时的计算资源，因此运行速度可能会较慢。
一个笔记本中的代码可能会影响另一个笔记本的运行时虚拟机的状态。例如，如果您在一个笔记本中安装了某个软件包的 1.3 版，但您的另一个笔记本需要 1.2 版，那么当您运行第二个笔记本时，可能会出现版本不兼容的情况。

您可以基于同一运行时模板为每个笔记本创建运行时，而不是在同一运行时中运行多个笔记本的代码。请参阅您可以根据同一运行时模板创建多个运行时。

运行时费用

您需要根据所使用的机器类型和加速器支付运行时处理费用。您还需要支付启动磁盘和数据磁盘存储费用。删除运行时时，系统会删除启动磁盘和数据磁盘。

除了运行时模板中指定的数据磁盘外，运行时始终包含一个 100 GiB SSD 永久性磁盘。启动磁盘不可配置。

在运行时关闭期间：

由于没有 CPU 或 GPU 使用情况，因此不会产生计算费用。
启动磁盘和数据磁盘存储空间会产生费用。

如需了解详情，请参阅 Colab Enterprise 价格。

您可以根据同一运行时模板创建多个运行时

您可以根据单个非默认运行时模板创建多个运行时。这样，您就可以在具有相同配置的虚拟机上运行多个笔记本，而无需共享该虚拟机的资源。

运行时模板

本部分介绍了运行时模板的特征。

运行时模板是区域级的

运行时模板是区域级的。创建运行时时，该运行时与运行时模板位于同一区域，并且只能与该区域中的笔记本搭配使用。

您可以与其他用户共享运行时模板。这样一来，每个用户都可以基于相同的运行时模板创建自己的运行时，因此多个用户可以在相同的虚拟机配置上运行相同的笔记本。

如需了解详情，请参阅管理对运行时模板的访问权限。

配置

运行时模板用于确定运行时虚拟机的配置。您可以指定以下任一值：

区域

选择笔记本所在的区域。根据运行时模板创建的运行时与运行时模板位于同一区域。如需让笔记本在运行时中运行代码，笔记本和运行时必须位于同一区域。

机器类型

您可以配置运行时模板的机器类型。如需了解机器类型，请参阅机器系列资源和比较指南。

数据磁盘

您可以在运行时模板中配置数据磁盘的磁盘类型和磁盘大小。

创建运行时时，系统还会包含一个启动磁盘。启动磁盘是 100 GiB SSD 永久性磁盘，无法配置。

加速器

您可以向运行时模板配置添加加速器。加速器的可用性取决于机器类型和区域。

网络

指定您的网络或使用项目的默认虚拟私有云网络。

空闲机器关停

Colab Enterprise 默认启用空闲关机。此设置会在实例处于非活跃状态 180 分钟后将其关闭。您可以更改关停前不活跃的分钟数，也可以停用空闲关停。

公共互联网访问权限

如需更好地控制笔记本和其他资源的安全，您可以关闭公共互联网访问权限。如果您以这种方式配置运行时模板，则使用从该运行时模板创建的运行时的笔记本将无法访问公共互联网。

最终用户凭据身份验证

默认情况下，运行时模板使用最终用户凭据身份验证来授予笔记本对应用默认凭据 (ADC) 的访问权限。您可以使用此 ADC 访问权限在笔记本中运行与 Agent Platform 和其他 Google Cloud 服务交互的代码。启用最终用户凭据后，笔记本会使用运行笔记本的人员的凭据来确定对 Google Cloud 资源的访问权限。

如果未启用最终用户凭据，您可以通过笔记本的代码对用户进行身份验证，从而获取对 ADC 的访问权限。如需了解详情，请参阅为本地开发环境设置 ADC 的“用户凭据”部分。

运行时模板费用

创建或存储运行时模板不会产生任何费用。另请参阅运行时费用。