创建 Vertex AI Workbench 实例

创建 Vertex AI Workbench 实例

本页面介绍了如何使用 Google Cloud 控制台或 Google Cloud CLI 创建 Vertex AI Workbench 实例。创建实例时，您可以配置实例的硬件、加密类型、网络和以及其他详细信息。

须知事项

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 Notebooks API.

   Enable the API

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 Notebooks API.

   Enable the API

创建实例

您可以使用 Google Cloud 控制台、gcloud CLI 或 Terraform 创建 Vertex AI Workbench 实例：

控制台

1. 在 Google Cloud 控制台中，进入实例页面。

   转到实例

2. 点击  新建。

3. 在新建实例对话框中，点击高级选项。

4. 在创建实例对话框的详细信息部分中，为新实例提供以下信息：

   • 名称：为新实例提供名称。 名称必须以字母开头，后面最多可跟 62 个小写字母、数字或连字符 (-)，但不能以连字符结尾。
   • 区域和可用区：为新实例选择区域和可用区。为获得最佳网络性能，请选择与您的地理位置最近的区域。 查看可用的 Vertex AI Workbench 位置。
   • 标签：可选。为实例提供自定义键值对标签。
   • 标记：可选。为实例提供标记。

5. 在环境部分中，提供以下信息：

   • 版本：使用最新版本或前一版本的 Vertex AI Workbench 实例。
   • 启动后脚本：可选。点击浏览，选择在实例创建后运行一次的脚本。该路径必须是网址或 Cloud Storage 路径，例如：gs://PATH_TO_FILE/FILE_NAME。
   • 元数据：可选。为实例提供自定义元数据键。

6. 在机器类型部分中，提供以下信息：

   • 机器类型：为新实例选择 CPU 数量和 RAM 容量。Vertex AI Workbench 会为您选择的每种机器类型提供每月估算费用。

   • GPU：可选。如果您需要 GPU，请为新实例选择 GPU 类型和 GPU 数量。所需的加速器类型必须在实例的可用区中可用。如需了解各可用区的加速器可用性，请参阅 GPU 区域和可用区可用性。如需了解各种 GPU，请参阅 Compute Engine 上的 GPU。

     选择自动为我安装 NVIDIA GPU 驱动程序。

     注意：您可以在创建实例后修改其机器类型和 GPU 配置。 如需了解详情，请参阅更改 Vertex AI Workbench 实例的机器类型并配置 GPU。

   • 安全强化型虚拟机：可选。选中或清除以下复选框：

     • 安全启动
     • 虚拟可信平台模块 (vTPM)
     • 完整性监控

   • 空闲机器关停：可选。

     • 如需更改关停前的分钟数，请在关停前保持非活跃状态的时间（分钟）字段中，将值更改为 10 到 1440 之间的整数。

     • 如需关闭空闲机器关停，请清除启用空闲机器关停。

7. 在磁盘部分中，提供以下信息：

   • 磁盘：可选。如需更改默认数据磁盘设置，请选择数据磁盘类型和数据磁盘大小 (GB)。如需详细了解磁盘类型，请参阅存储选项。

   • 删除至回收站可选：选中此复选框以使用操作系统的默认回收站行为。如果您使用默认回收站行为，则使用 JupyterLab 界面删除的文件可以恢复，但这些已删除的文件会占用磁盘空间。

   • 加密：选择 Google 管理的加密密钥或客户管理的加密密钥 (CMEK)。如需使用 CMEK，请参阅客户管理的加密密钥。

8. 在网络部分中，提供以下信息：

   • 网络：调整网络选项，以在宿主项目中使用当前项目的网络或共享 VPC 网络（如果已配置）。如果您在宿主项目中使用共享 VPC，则还必须在服务项目中向 Notebooks Service Agent 授予 Compute Network User 角色 (roles/compute.networkUser)。

     1. 在网络字段中，选择所需的网络。您可以选择 VPC 网络，只要该网络启用了专用 Google 访问通道或者可以访问互联网即可。如需了解详情，请参阅网络配置选项。

     2. 在子网字段中，选择所需的子网。

     3. 如需关闭外部 IP 地址，请清除分配外部 IP 地址复选框。

     4. 如需关闭代理访问权限，请清除允许代理访问权限复选框。

        注意：如果您关闭代理访问权限，则必须使用 SSH 连接到实例的 JupyterLab 界面。

9. 在 IAM 和安全部分，提供以下信息：

   • IAM 和安全：如需授予对实例的 JupyterLab 界面的访问权限，请完成以下步骤之一：

     • 如需通过服务账号向 JupyterLab 授予访问权限，请选择服务账号。

       • 如需使用默认的 Compute Engine 服务账号，请选择 Use default Compute Engine service account。

       • 如需使用自定义服务账号，请清除 Use default Compute Engine service account，然后在服务账号电子邮件地址字段中输入您的自定义服务账号电子邮件地址。

     • 如需为单个用户授予对 JupyterLab 界面的访问权限，请执行以下操作：

       1. 选择单个用户，然后在用户电子邮件字段中输入要授予访问权限的用户账号。如果指定用户不是实例的创建者，您必须向指定用户授予实例的服务账号的 Service Account User 角色 (roles/iam.serviceAccountUser)。

       2. 您的实例使用服务账号与 Google Cloud 服务和 API 进行交互。

          • 如需使用默认的 Compute Engine 服务账号，请选择使用默认 Compute Engine 服务账号。

          • 如需使用自定义服务账号，请清除使用默认的 Compute Engine 服务账号，然后在服务账号电子邮件地址字段中输入您的自定义服务账号电子邮件地址。

     注意：如需通过服务账号或单用户选项授予对实例的访问权限，您必须使用个人用户账号电子邮件地址。不支持群组访问。

     如需详细了解如何授予访问权限，请参阅管理访问权限。

   • 安全选项：选中或清除以下复选框：

     • 对实例的根访问权限
     • nbconvert
     • 文件下载
     • 终端访问权限

10. 在系统健康状况部分中，提供以下信息：

    • 环境升级和系统健康状况：如需自动升级到新发布的环境版本，请选择环境自动升级并完成升级时间表。

    • 在报告中，选中或清除以下复选框：

      • 报告系统健康状况
      • 向 Cloud Monitoring 报告自定义指标
      • 安装 Cloud Monitoring
      • 报告所需 Google 网域的 DNS 状态

11. 点击创建。

    Vertex AI Workbench 会创建实例并自动启动该实例。当实例可供使用时，Vertex AI Workbench 会激活一个打开 JupyterLab 链接。

gcloud

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

• INSTANCE_NAME：Vertex AI Workbench 实例的名称；必须以字母开头，后面最多可跟 62 个小写字母、数字或连字符 (-)，但不能以连字符结尾
• PROJECT_ID：您的项目 ID
• LOCATION：您希望实例所在的可用区
• VM_IMAGE_PROJECT：虚拟机映像所属的 Google Cloud 项目的 ID，格式为 projects/IMAGE_PROJECT_ID
• VM_IMAGE_NAME：完整的映像名称；如需查找特定版本的映像名称，请参阅查找特定版本
• MACHINE_TYPE：实例虚拟机的机器类型
• METADATA：要应用于此实例的自定义元数据；例如，如需指定 post-startup-script，您可以使用 post-startup-script 元数据标记，格式为 "--metadata=post-startup-script=gs://BUCKET_NAME/hello.sh"

执行以下命令：

Linux、macOS 或 Cloud Shell

注意：通过运行 gcloud init 或 gcloud auth login 和 gcloud config set project，确保您已使用身份验证和项目初始化了 Google Cloud CLI。

gcloud workbench instances create INSTANCE_NAME --project=PROJECT_ID --location=LOCATION --vm-image-project=VM_IMAGE_PROJECT --vm-image-name=VM_IMAGE_NAME --machine-type=MACHINE_TYPE --metadata=METADATA

Windows (PowerShell)

注意：通过运行 gcloud init 或 gcloud auth login 和 gcloud config set project，确保您已使用身份验证和项目初始化了 Google Cloud CLI。

gcloud workbench instances create INSTANCE_NAME --project=PROJECT_ID --location=LOCATION --vm-image-project=VM_IMAGE_PROJECT --vm-image-name=VM_IMAGE_NAME --machine-type=MACHINE_TYPE --metadata=METADATA

Windows (cmd.exe)

注意：通过运行 gcloud init 或 gcloud auth login 和 gcloud config set project，确保您已使用身份验证和项目初始化了 Google Cloud CLI。

gcloud workbench instances create INSTANCE_NAME --project=PROJECT_ID --location=LOCATION --vm-image-project=VM_IMAGE_PROJECT --vm-image-name=VM_IMAGE_NAME --machine-type=MACHINE_TYPE --metadata=METADATA

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

Vertex AI Workbench 会创建实例并自动启动该实例。当实例可供使用时，Vertex AI Workbench 会在 Google Cloud 控制台中激活打开 JupyterLab 链接。

Terraform

以下示例使用 google_workbench_instance Terraform 资源创建名为 workbench-instance-example 的 Vertex AI Workbench 实例。

如需了解如何应用或移除 Terraform 配置，请参阅基本 Terraform 命令。

resource "google_workbench_instance" "default" {
  name     = "workbench-instance-example"
  location = "us-central1-a"

  gce_setup {
    machine_type = "n1-standard-1"
    accelerator_configs {
      type       = "NVIDIA_TESLA_T4"
      core_count = 1
    }
    vm_image {
      project = "cloud-notebooks-managed"
      family  = "workbench-instances"
    }
  }
}

网络配置选项

Vertex AI Workbench 实例必须访问 VPC 网络之外的服务端点。

您可以通过以下方式之一提供此访问权限：

• 为实例分配外部 IP 地址。当您创建新实例时，系统会默认执行此操作。确保您的环境符合访问 Google API 和服务的要求。

• 将该实例连接到启用了专用 Google 访问通道的子网。确保您的环境符合专用 Google 访问通道的要求。

如果您使用 private.googleapis.com 或 restricted.googleapis.com VIP 地址来提供对服务端点的访问权限，请为每个必需的服务端点添加 DNS 条目：

• notebooks.googleapis.com
• *.notebooks.cloud.google.com
• *.notebooks.googleusercontent.com

此外，对于已启用 Dataproc 的实例，请为以下内容添加 DNS 条目：

• *.kernels.googleusercontent.com

注意：Dataproc JupyterLab 插件不支持 VPC Service Controls（请参阅支持 Dataproc 的限制），因此您必须为实例使用 private.googleapis.com VIP 或关闭 Dataproc。

网络标记

新的 Vertex AI Workbench 实例自动分配有 deeplearning-vm 和 notebook-instance 网络标记。

这些标记可让您通过在 VPC 网络防火墙规则中引用该标记来管理进出 Vertex AI Workbench 实例的网络访问权限。如需详细了解网络标记，请参阅添加网络标记。

如需查看 Vertex AI Workbench 实例的网络标记，请执行以下操作：

1. 在 Google Cloud 控制台中，前往虚拟机实例页面。

   进入“虚拟机实例”

2. 点击实例的名称。

3. 在网络部分中，找到网络标记。

问题排查

如果在创建笔记本时遇到问题，请参阅排查 Vertex AI Workbench 问题以获取常见问题的帮助。

后续步骤

1. 如需使用 Jupyter Notebook 开始使用 Vertex AI 和其他 Google Cloud 服务，请参阅 Vertex AI Jupyter Notebook 教程。
2. 如需检查 Vertex AI Workbench 实例的健康状况，请参阅监控健康状况。