创建特定版本的实例

本页面介绍了如何创建特定版本的 Gemini Enterprise Agent Platform Workbench 实例。

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

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

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

如需详细了解特定 Agent Platform Workbench 版本，请参阅 Agent Platform 版本说明。

创建特定版本的 Agent Platform Workbench 实例后，您可以升级该实例。 升级实例会更新预装的软件和软件包。 如需了解详情，请参阅升级实例的环境。

准备工作

  1. 登录您的 Google Cloud 账号。如果您是 Google Cloud新手，请 创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金，用于运行、测试和部署工作负载。

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Notebooks API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Notebooks API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

    8.

创建特定版本

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

控制台

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

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

  2. 点击版本列表，然后选择一个版本。版本按如下格式进行编号：M，后跟发布版本号，例如 M123。

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

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

gcloud

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

  • INSTANCE_NAME：Agent Platform 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 文档。

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

后续步骤