在 Colab Enterprise 中连接到运行时

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

   转到 Notebooks

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 Notebooks 页面。

   转到 Notebooks

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

3. 在我的笔记本标签页中，点击要打开的笔记本。如果您尚未创建笔记本，请创建笔记本。

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

   系统随即会打开连接到 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 Notebooks 页面。

   转到 Notebooks

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 授予对用户凭据的访问权限。

      

   3. 点击继续。

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

问题排查

本部分介绍了如何解决在 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 的出站流量。

后续步骤

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