创建 Vertex AI Workbench 实例

控制台

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

   转到实例

2. 点击 add_box 新建。

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

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

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

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

   • JupyterLab 版本：如需启用 JupyterLab 4（预览版），请选择 JupyterLab 4.x。如果未选中，您的实例将使用 JupyterLab 3。如需了解详情，请参阅 JupyterLab 4 预览版。
   • 版本：使用最新版本或前一版本的 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 驱动程序。

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

     • 安全启动
     • 虚拟可信平台模块 (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. 如需关闭代理访问权限，请清除允许代理访问权限复选框。

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，格式为 IMAGE_PROJECT_ID。受支持映像的默认 Google Cloud 项目 ID 为 cloud-notebooks-managed。
• VM_IMAGE_NAME：完整的映像名称；如需查找特定版本的映像名称，请参阅查找特定版本
• MACHINE_TYPE：实例虚拟机的机器类型

• METADATA：要应用于此实例的自定义元数据；例如，如需指定 post-startup-script，您可以使用 post-startup-script 元数据标记，格式为 --metadata=post-startup-script=gs://BUCKET_NAME/hello.sh

执行以下命令：

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 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 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"
    }
  }
}

控制台

如需更改现有实例上的 JupyterLab 版本，请执行以下操作：

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

   转到实例

2. 点击实例名称，打开实例详情页面。

3. 在系统标签页中，执行以下操作之一：

   • 如需启用预览版，请选择启用 JupyterLab 4 预览版。

   • 如需关闭预览版并使用 JupyterLab 3，请取消选中启用 JupyterLab 4 预览版。

4. 点击提交。

5. 重置实例。

gcloud

您可以使用以下命令更改现有实例上的 JupyterLab 版本：

gcloud workbench instances update INSTANCE_NAME \
    --project="PROJECT_ID" \
    --location="LOCATION" \
    --metadata=enable-jupyterlab4-preview=ENABLEMENT_BOOLEAN

替换以下内容：

• PROJECT_ID：您的项目 ID
• LOCATION：您希望实例所在的可用区
• INSTANCE_NAME：您的 Vertex AI Workbench 实例的名称

• ENABLEMENT_BOOLEAN：使用以下任一方法：

  • true：启用 JupyterLab 4 预览版
  • false：关闭 JupyterLab 4 预览版并改用 JupyterLab 3