运行时和运行时模板

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

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

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

工作流

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

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

1. 创建具有所需配置的运行时模板。

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

3. 从笔记本连接到运行时，然后运行代码。

运行时

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

默认运行时

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

当 Colab Enterprise 创建默认运行时时，它会先创建相应的默认运行时模板。运行时和运行时模板都会显示在 Google Cloud 控制台中，您可以在其中获取有关它们的信息。

如果您使用不含加速器的默认运行时，Colab Enterprise 会为每个项目、每个区域创建一个不含加速器的默认运行时及其对应的运行时模板。

如果您使用带加速器的默认运行时，Colab Enterprise 会为每个项目、每个区域创建一个带加速器的默认运行时及其对应的运行时模板。

默认运行时规范

默认运行时及其对应的默认运行时模板包含以下规范：

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 -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"

$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

如需了解详情，请参阅 notebookRuntimeTemplates.patch REST API 文档。

运行时是区域级的

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

运行时专属于一位用户

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

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

管理运行时文件

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

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

运行时可由笔记本共享

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

• 由于笔记本共享了运行时的计算资源，因此运行速度可能会较慢。

• 一个笔记本中的代码可能会影响另一个笔记本的运行时虚拟机的状态。例如，如果您在一个笔记本中安装了 1.3 版本的软件包，但另一个笔记本需要 1.2 版本，那么在运行第二个笔记本时，可能会出现版本不兼容的情况。

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

运行时费用

您需要按照所使用的机器类型和加速器支付运行时处理费用。您还需要为启动磁盘和数据磁盘存储空间付费。删除运行时后，启动磁盘和数据磁盘也会被删除。

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

在运行时关闭期间：

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

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

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

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

运行时模板

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

运行时模板是区域级的

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

可以与用户共享运行时模板

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

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

配置

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

区域

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

机器类型

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

数据磁盘

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

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

加速器

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

网络

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

空闲机器关停

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

公共互联网访问权限

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

最终用户凭据身份验证

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

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

运行时模板费用

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

后续步骤

• 根据运行时模板创建运行时。
• 连接到运行时。
• 创建运行时模板。