连接到运行时

连接到运行时

本页介绍了如何在 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.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the 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. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the 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

使用不同的方法进行连接

本页介绍了如何使用以下方法连接到运行时：

• 使用默认运行时
• 连接到现有运行时
• 创建运行时

使用默认运行时

本部分介绍了如何连接到默认运行时。

所需的角色

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

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

一个或多个必需的角色可提供 dataform.repositories.list 权限。在项目中被授予 dataform.repositories.list 权限或 Code Creator (roles/dataform.codeCreator) 角色的用户可以使用 Dataform API 或 Dataform 命令行界面 (CLI) 列出该项目中代码资产的名称。使用 BigQuery Studio 的非管理员只能看到他们创建或与他们共享的代码资产。

连接到默认运行时

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

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

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

   前往“我的笔记本”

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

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

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

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

   默认运行时默认启用了最终用户凭据。如需使用无权访问用户凭据的运行时，请创建一个未启用最终用户凭据的运行时模板。

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

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

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

      

   3. 点击继续。

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

连接到现有运行时

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

所需的角色

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

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

一个或多个必需的角色可提供 dataform.repositories.list 权限。在项目中被授予 dataform.repositories.list 权限或 Code Creator (roles/dataform.codeCreator) 角色的用户可以使用 Dataform API 或 Dataform 命令行界面 (CLI) 列出该项目中代码资产的名称。使用 BigQuery Studio 的非管理员只能看到他们创建或与他们共享的代码资产。

连接到现有运行时

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

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

   前往“我的笔记本”

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

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

4. 在笔记本中，点击其他连接选项展开箭头，然后选择连接到运行时。
   

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

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

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

7. 点击连接。

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

   如需使用无权访问用户凭据的运行时，请创建一个未启用最终用户凭据的运行时模板。

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

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

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

      

   3. 点击继续。

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

创建运行时

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

所需的角色

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

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

一个或多个必需的角色可提供 dataform.repositories.list 权限。在项目中被授予 dataform.repositories.list 权限或 Code Creator (roles/dataform.codeCreator) 角色的用户可以使用 Dataform API 或 Dataform 命令行界面 (CLI) 列出该项目中代码资产的名称。使用 BigQuery Studio 的非管理员只能看到他们创建或与他们共享的代码资产。

创建运行时并连接到它

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

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

   前往“我的笔记本”

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

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

4. 在笔记本中，点击其他连接选项展开箭头，然后选择连接到运行时。
   

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

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

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

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

8. 点击连接。

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

   如需使用无权访问用户凭据的运行时，请创建一个未启用最终用户凭据的运行时模板。

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

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

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

      

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

后续步骤

• 详细了解运行时和运行时模板。
• 创建运行时模板。