运行时和运行时模板

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

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

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

工作流

您可以创建 Colab Enterprise 笔记本并在其中运行代码，而无需了解运行时。首次运行代码时，Colab Enterprise 会预配默认运行时并在其中运行代码。 在您连接到其他运行时之前，Colab Enterprise 会继续使用默认运行时。

如需根据特定需求配置运行时，您必须：

  1. 使用所需的配置创建运行时模板。

  2. 根据该模板创建运行时。

  3. 从笔记本连接到运行时并运行代码。

运行时

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

默认运行时

如果您未创建运行时，则在您首次运行代码或连接到默认运行时时，系统会为您创建一个不带加速器的运行时。 您可以使用不带加速器的默认运行时，也可以切换到包含加速器的默认运行时。

当 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。

控制台

如需修改运行时模板，请执行以下操作：

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

    进入运行时模板

  2. 在区域 菜单中，选择包含 您的运行时模板的区域。

  3. 在 ID 列中，点击要修改的运行时模板的 ID 编号。

  4. 点击 修改图标。

  5. 在修改运行时模板 面板中，对运行时模板进行更改。

  6. 点击更新 。

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
如果成功，响应正文将包含一个 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 版本。
    • 现有运行时不再可升级。
    • 运行时会在最近一次升级后六个月停止运行，如果未升级，则会在创建后六个月停止运行。

    如需申请将此 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 的“用户凭据”部分。

运行时模板费用

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

后续步骤