在 Colab Enterprise 中创建运行时

本页介绍了如何在 Vertex AI 中创建、启动和删除运行时。

您可以创建一个运行时，以便在具有与默认配置不同的运行时上运行代码。运行时是根据运行时模板创建的，其中包括机型和磁盘大小等规范。

如需详细了解运行时，请参阅运行时和运行时模板。

准备工作

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Vertex AI, Dataform, and Compute Engine APIs.

    Enable the APIs

    5.

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Vertex AI, Dataform, and Compute Engine APIs.

    Enable the APIs

    8.

所需的角色

如需确保您的用户账号具有在 Colab Enterprise 中创建运行时所需的权限，请让您的管理员向您的用户账号授予项目的 Colab Enterprise Admin (roles/aiplatform.colabEnterpriseAdmin) IAM 角色。如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

您的管理员还可以通过自定义角色或其他预定义角色向您的用户账号授予所需的权限。

创建运行时

如需创建运行时，您可以使用 Google Cloud 控制台或 Google Cloud CLI。

控制台

如需创建运行时，请执行以下操作：

  1. 在 Google Cloud 控制台中，转到 Colab Enterprise 运行时页面。

    转到“运行时”

  2. 在区域菜单中，选择要运行运行时环境的区域。它必须与使用它的笔记本位于同一区域。

  3. 点击  创建运行时。

    此时会显示创建 Vertex AI 运行时对话框。

  4. 在运行时模板菜单中，选择一个运行时模板。如果未列出任何运行时模板，请创建运行时模板。

  5. 在运行时名称字段中，输入运行时的名称。

  6. 点击创建。

默认情况下，当您创建运行时时，系统会自动为您授予启动和删除该运行时所需的权限。

gcloud

在使用下面的命令数据之前，请先进行以下替换：

  • DISPLAY_NAME：运行时的显示名称。
  • RUNTIME_TEMPLATE_ID：运行时模板的 ID。运行时模板用于指定运行时的计算配置。
  • PROJECT_ID：您的项目 ID。
  • REGION：您希望运行时所在的区域。

执行以下命令：

Linux、macOS 或 Cloud Shell

gcloud colab runtimes create --display-name="DISPLAY_NAME" \
    --runtime-template=RUNTIME_TEMPLATE_ID \
    --project=PROJECT_ID \
    --region=REGION

Windows (PowerShell)

gcloud colab runtimes create --display-name="DISPLAY_NAME" `
    --runtime-template=RUNTIME_TEMPLATE_ID `
    --project=PROJECT_ID `
    --region=REGION

Windows (cmd.exe)

gcloud colab runtimes create --display-name="DISPLAY_NAME" ^
    --runtime-template=RUNTIME_TEMPLATE_ID ^
    --project=PROJECT_ID ^
    --region=REGION

默认情况下，当您创建运行时时，您会自动获得启动和删除该运行时所需的权限。

如需详细了解用于从命令行创建运行时模板的命令，请参阅 gcloud CLI 文档。

启动运行时

如需启动运行时，您可以使用 Google Cloud 控制台或 gcloud CLI。

控制台

如需启动运行时，请执行以下操作：

  1. 在 Google Cloud 控制台中，转到 Colab Enterprise 运行时页面。

    转到“运行时”

  2. 在区域菜单中，选择包含运行时环境的区域。

  3. 选择要启动的运行时。

  4. 点击开始。

gcloud

在使用下面的命令数据之前，请先进行以下替换：

  • RUNTIME_ID：您的运行时的 ID。
  • PROJECT_ID：您的项目 ID。
  • REGION：运行时所在的区域。

执行以下命令：

Linux、macOS 或 Cloud Shell

gcloud colab runtimes start RUNTIME_ID \
    --project=PROJECT_ID \
    --region=REGION

Windows (PowerShell)

gcloud colab runtimes start RUNTIME_ID `
    --project=PROJECT_ID `
    --region=REGION

Windows (cmd.exe)

gcloud colab runtimes start RUNTIME_ID ^
    --project=PROJECT_ID ^
    --region=REGION

如需详细了解用于从命令行创建运行时模板的命令，请参阅 gcloud CLI 文档。

删除运行时

如需删除运行时，您可以使用 Google Cloud 控制台或 gcloud CLI。

控制台

如需删除运行时，请执行以下操作：

  1. 在 Google Cloud 控制台中，转到 Colab Enterprise 运行时页面。

    转到“运行时”

  2. 在区域菜单中，选择包含运行时环境的区域。

  3. 选择要删除的运行时。

  4. 点击 删除。

  5. 点击确认。

gcloud

在使用下面的命令数据之前，请先进行以下替换：

  • RUNTIME_ID：您的运行时的 ID。
  • PROJECT_ID：您的项目 ID。
  • REGION：运行时所在的区域。

执行以下命令：

Linux、macOS 或 Cloud Shell

gcloud colab runtimes delete RUNTIME_ID \
    --project=PROJECT_ID \
    --region=REGION

Windows (PowerShell)

gcloud colab runtimes delete RUNTIME_ID `
    --project=PROJECT_ID `
    --region=REGION

Windows (cmd.exe)

gcloud colab runtimes delete RUNTIME_ID ^
    --project=PROJECT_ID ^
    --region=REGION

如需详细了解用于从命令行创建运行时模板的命令，请参阅 gcloud CLI 文档。

问题排查

本部分介绍了如何解决在 Colab Enterprise 中创建运行时的问题。

无法创建运行时

当您无法创建运行时时，就会出现此问题。另请参阅无法创建默认运行时。最常见的原因如下：

配额不足

如果您无法创建运行时，则可能已超出 Compute Engine 运行时配额。

Colab Enterprise 为运行时使用 Compute Engine 配额。如需了解详情，请参阅 Compute Engine 配额和限制概览。

如需解决此问题，请申请更高的配额限制。

无法获得的资源

尝试创建运行时时发生以下错误。

No available zone found for runtime RUNTIME_ID
for machine type MACHINE_TYPE
with accelerator type: ACCELERATOR. Please try again later.

如果笔记本区域中的机型配置没有可用的资源，则会出现此错误。

如需解决此问题，请尝试使用其他机器类型配置的运行时，或稍后重试。

默认运行时已存在

如果默认运行时已存在，而您尝试根据默认运行时模板创建运行时，则会发生以下错误。

Failed to create runtime

One click runtime already exists.

如果您尝试根据默认运行时模板创建运行时，Colab Enterprise 会尝试创建默认运行时。每个用户、项目和区域只能有一个默认运行时。如果默认运行时已存在，Colab Enterprise 将无法再创建其他默认运行时。

如需解决此问题，请连接到现有的默认运行时，或根据非默认运行时模板创建运行时。

无法创建默认运行时

当 Colab Enterprise 创建默认运行时时，它会先创建一个默认运行时模板，然后使用该模板生成默认运行时。如果您尝试创建默认运行时，但没有创建运行时模板所需的权限，则 Colab Enterprise 无法创建默认运行时。

要解决此问题，请让管理员向您授予包含 aiplatform.notebookRuntimeTemplates.create 权限的角色。

后续步骤