连接到运行时

本页介绍了如何在 Colab Enterprise 中连接到运行时。

如需在笔记本中运行代码，您必须连接到运行时。运行时是运行代码的计算资源。

须知事项

  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 User (roles/aiplatform.colabEnterpriseUser) IAM 角色。如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

连接到默认运行时

当您首次在笔记本中运行代码时，Colab Enterprise 会自动连接到默认运行时，除非您指定了其他运行时。

如需在不运行代码的情况下连接到默认运行时，请执行以下操作：

  1. 在 Google Cloud 控制台中，前往 Colab Enterprise 我的笔记本页面。

    前往我的笔记本

  2. 在区域菜单中，选择包含您的笔记本的区域。

  3. 点击您要打开的笔记本。如果您尚未创建笔记本，请创建一个笔记本。

  4. 在笔记本中，点击连接。

  5. 如果这是您第一次连接到启用了最终用户凭据的运行时，系统会显示登录对话框。

    如需为 Colab Enterprise 授予对用户凭据的访问权限，请完成以下步骤：

    1. 在登录对话框中，点击您的用户账号。

    2. 选择查看、修改、配置和删除您的 Google Cloud 数据...，为 Colab Enterprise 授予对用户凭据的访问权限。

      复选框在“查看、修改、配置和删除您的 Google Cloud 数据，并查看您的 Google 账号的电子邮件地址”句子的旁边。

    3. 点击继续。

Colab Enterprise 会连接到默认运行时。如果默认运行时未运行，Colab Enterprise 会启动默认运行时，然后连接到该运行时。

连接到现有运行时

本部分介绍了如何使用连接到 Vertex AI 运行时对话框连接到现有运行时。

所需的角色

如需获得连接到 Colab Enterprise 笔记本中的现有运行时所需的权限，请让您的管理员为您授予项目的 Colab Enterprise User (roles/aiplatform.colabEnterpriseUser) IAM 角色。如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

连接到现有运行时

如需连接到现有运行时，请执行以下操作：

  1. 在 Google Cloud 控制台中，前往 Colab Enterprise 我的笔记本页面。

    前往我的笔记本

  2. 在区域菜单中，选择包含您的笔记本的区域。

  3. 点击您要打开的笔记本。如果您尚未创建笔记本，请创建一个笔记本。

  4. 在笔记本中，点击 Additional connection options（其他连接选项）展开箭头，然后选择 Connect to a runtime（连接到运行时）。

    系统会打开连接到 Vertex AI 运行时对话框。

  5. 在选择运行时部分，选择连接到现有运行时。

  6. 在选择现有运行时选项中，选择要连接到的运行时。如果列表中没有任何运行时，请创建运行时或连接到默认运行时。

  7. 点击连接。

  8. 如果运行时启用了最终用户凭据，并且这是您第一次连接到启用了最终用户凭据的运行时，系统会显示登录对话框。

    如需为 Colab Enterprise 授予对用户凭据的访问权限，请完成以下步骤：

    1. 在登录对话框中，点击您的用户账号。

    2. 选择查看、修改、配置和删除您的 Google Cloud 数据...，为 Colab Enterprise 授予对用户凭据的访问权限。

      复选框在“查看、修改、配置和删除您的 Google Cloud 数据，并查看您的 Google 账号的电子邮件地址”句子的旁边。

    3. 点击继续。

Colab Enterprise 会连接到运行时。如果运行时未运行，Colab Enterprise 会启动运行时，然后连接到该运行时。

创建运行时

本部分介绍了如何使用连接到 Vertex AI 运行时对话框创建运行时并连接到该运行时。或者，您也可以在运行时标签页中创建运行时。

所需的角色

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

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

创建运行时并连接到该运行时

如需创建运行时并使用连接到 Vertex AI 运行时对话框连接到该运行时，请执行以下操作：

  1. 在 Google Cloud 控制台中，前往 Colab Enterprise 我的笔记本页面。

    前往我的笔记本

  2. 在区域菜单中，选择包含您的笔记本的区域。

  3. 点击您要打开的笔记本。如果您尚未创建笔记本，请创建一个笔记本。

  4. 在笔记本中，点击 Additional connection options（其他连接选项）展开箭头，然后选择 Connect to a runtime（连接到运行时）。

    系统会打开连接到 Vertex AI 运行时对话框。

  5. 在选择运行时部分，选择创建新的运行时。

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

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

  8. 点击连接。

  9. 如果您选择的运行时模板启用了最终用户凭据，并且这是您第一次连接到启用了最终用户凭据的运行时，系统会显示登录对话框。

    如需为 Colab Enterprise 授予对用户凭据的访问权限，请完成以下步骤：

    1. 在登录对话框中，点击您的用户账号。

    2. 选择查看、修改、配置和删除您的 Google Cloud 数据...，为 Colab Enterprise 授予对用户凭据的访问权限。

      复选框在“查看、修改、配置和删除您的 Google Cloud 数据，并查看您的 Google 账号的电子邮件地址”句子的旁边。

    3. 点击继续。

Colab Enterprise 会启动默认运行时，然后连接到该运行时。

运行时管理

默认情况下，当您创建运行时时，您会自动获得删除 (aiplatform.googleapis.com/notebookRuntimes.delete) 和启动 (aiplatform.googleapis.com/notebookRuntimes.start) 该运行所需的权限。

问题排查

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

无法连接到运行时

导致此问题的原因有很多。另请参阅无法连接到默认运行时。最常见的原因如下：

浏览器屏蔽第三方 Cookie

您使用的浏览器会屏蔽 Colab Enterprise 用于与运行时建立 HTTPS 连接的第三方 Cookie。

如需解决此问题，请配置浏览器的设置，以允许来自网域 *.aiplatform-notebook.googleusercontent.com 的 DATALAB_TUNNEL_TOKEN 第三方 Cookie。

网络阻止流向笔记本网域的出站流量

网络的防火墙规则阻止流向 *.aiplatform-notebook.cloud.google.com 或 *aiplatform.googleapis.com 的出站流量。

如需解决此问题，请配置网络的防火墙规则，以允许流向 *.aiplatform-notebook.cloud.google.com 和 *aiplatform.googleapis.com 的出站流量。

无法连接到默认运行时

如果不存在现有的默认运行时模板，则您尝试连接到默认运行时时，会发生以下错误。

Failed to connect to runtime

当您连接到尚未创建的默认运行时时，Colab Enterprise 会先创建一个默认运行时模板，然后使用该默认运行时模板生成默认运行时。 不过，如果您没有创建运行时模板所需的权限，则 Colab Enterprise 无法创建默认运行时模板和默认运行时。

如需解决此问题，请让您的管理员为您授予可提供 aiplatform.notebookRuntimeTemplates.create 权限的角色。

笔记本连接到运行时的速度缓慢

开始连接到运行时几分钟后，Connecting 消息仍显示在笔记本的右上角，并且 Colab Enterprise 尚未连接到运行时。

如需解决此问题，请再等待几分钟。Colab Enterprise 仍在连接到运行时。连接到尚未运行的运行时可能需要几分钟时间，因为 Vertex AI 正在分配新的虚拟机 (VM) 实例。

无法创建运行时

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

无法获得的资源

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

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 权限的角色。

后续步骤