创建特定版本的实例

本页介绍了如何创建特定版本的 Vertex AI Workbench 实例。

您可能希望创建特定版本的原因

为确保您的 Vertex AI Workbench 实例具有与您的代码或应用兼容的软件，您可能需要创建特定的版本。

Vertex AI Workbench 实例映像会频繁更新，预安装的软件和软件包的特定版本因版本而异。

如需详细了解特定的 Vertex AI Workbench 版本，请参阅 Vertex AI 版本说明。

创建特定版本的 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.

    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.

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

    Enable the API

    8.

创建特定版本

您可以使用 Google Cloud 控制台或 Google Cloud CLI 创建特定版本的 Vertex AI Workbench 实例。

控制台

如需创建特定版本的 Vertex AI Workbench 实例，请执行以下操作：

  1. 创建实例时，请在环境部分中选择使用先前版本。

  2. 点击版本列表，然后选择一个版本。版本编号格式为 M，后跟版本号，例如 M123。

  3. 完成实例创建对话框的其余部分，然后点击创建。

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

gcloud

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

  • INSTANCE_NAME：Vertex AI Workbench 实例的名称；必须以字母开头，后面最多可跟 62 个小写字母、数字或连字符 (-)，但不能以连字符结尾
  • PROJECT_ID：您的项目 ID
  • LOCATION：您希望实例所在的可用区
  • VM_IMAGE_NAME：映像名称；如需获取可用映像名称的列表，请使用 get-config 命令
  • MACHINE_TYPE：实例虚拟机的机器类型

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

执行以下命令：

Linux、macOS 或 Cloud Shell

gcloud workbench instances create INSTANCE_NAME \
    --project=PROJECT_ID \
    --location=LOCATION \
    --vm-image-project="cloud-notebooks-managed" \
    --vm-image-name=VM_IMAGE_NAME \
    --machine-type=MACHINE_TYPE \
    --metadata=METADATA

Windows (PowerShell)

gcloud workbench instances create INSTANCE_NAME `
    --project=PROJECT_ID `
    --location=LOCATION `
    --vm-image-project="cloud-notebooks-managed" `
    --vm-image-name=VM_IMAGE_NAME `
    --machine-type=MACHINE_TYPE `
    --metadata=METADATA

Windows (cmd.exe)

gcloud workbench instances create INSTANCE_NAME ^
    --project=PROJECT_ID ^
    --location=LOCATION ^
    --vm-image-project="cloud-notebooks-managed" ^
    --vm-image-name=VM_IMAGE_NAME ^
    --machine-type=MACHINE_TYPE ^
    --metadata=METADATA

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

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

后续步骤