管理图片版本

本页面介绍了如何管理 Gemini Enterprise Agent Platform Workbench 实例的映像版本，包括如何执行以下操作：

  • 列出可用的图片名称
  • 基于特定映像名称创建实例
  • 在映像系列之间升级或移动实例

如需了解版本控制方案、映像内容和生命周期，请参阅映像版本控制和生命周期。

如需了解每个版本中的变化，请参阅映像版本说明。

虚拟机映像

本部分介绍如何列出可用的虚拟机映像、基于特定虚拟机映像创建实例，以及升级实例的虚拟机映像。

列出可用的虚拟机映像

虚拟机映像存储在私有代码库中。如需列出可用的虚拟机映像及其支持的配置，请使用 gcloud workbench instances get-config 或 GetConfig API。

gcloud

gcloud workbench instances get-config --location=LOCATION

将 LOCATION 替换为 Google Cloud 区域，例如 us-central1。

cURL

curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://notebooks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/instances:getConfig"

替换以下内容：

  • PROJECT_ID：您的 Google Cloud 项目 ID。
  • LOCATION：您要检索配置的区域。

使用特定虚拟机映像创建实例

如需在特定虚拟机映像上创建实例，请使用 gcloud CLI 或 Terraform。您可以指定映像系列以获取其最新映像名称，也可以指定映像名称以获取确切的版本。

gcloud

# Using an image family
gcloud workbench instances create INSTANCE_NAME \
  --vm-image-project=cloud-notebooks-managed \
  --vm-image-family=IMAGE_FAMILY \
  --location=LOCATION

# Using a specific image name
gcloud workbench instances create INSTANCE_NAME \
  --vm-image-project=cloud-notebooks-managed \
  --vm-image-name=IMAGE_NAME \
  --location=LOCATION

替换以下内容：

Terraform 

resource "google_workbench_instance" "vm_instance" {
  # ... other configurations
  gce_setup {
    vm_image {
      project = "cloud-notebooks-managed"
      family  = "IMAGE_FAMILY" # Or specify image name to get an exact version
    }
  }
  # ...
}

升级虚拟机映像

默认情况下，实例会升级到其当前映像系列中的最新映像名称。如需使用旧版映像名称，请根据特定映像名称创建新实例。

gcloud

gcloud workbench instances upgrade INSTANCE_NAME --location=LOCATION

替换以下内容：

  • INSTANCE_NAME：实例的名称。
  • LOCATION：实例所在的区域。

Terraform

在 Terraform 配置中，设置 google_workbench_instance 资源中的 vm_image 块。

resource "google_workbench_instance" "vm_instance" {
  # ... other configurations
  gce_setup {
    vm_image {
      project = "cloud-notebooks-managed"
      family  = "workbench-instances-2603" # Or use name = "workbench-instances-2603-20240315-1800-rc0"
    }
  }
  # ...
}

如需详细了解如何创建特定版本的实例，请参阅创建特定版本。

跨映像系列进行升级

如需将实例更改为其他映像系列中的最新映像名称（例如，从 workbench-instances 更改为较新的 workbench-instances-2603），请在升级期间指定目标映像系列。这是在不重新创建实例的情况下，在主要版本之间切换的受支持途径。

gcloud

将 --image-family 标志与 gcloud workbench instances upgrade 搭配使用，以指定目标映像系列。实例会升级到指定系列中的最新映像。

gcloud workbench instances upgrade INSTANCE_NAME \
  --location=LOCATION \
  --image-family=projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY

替换以下内容：

  • INSTANCE_NAME：实例的名称。
  • LOCATION：实例所在的区域。
  • IMAGE_PROJECT：托管映像系列的映像项目（例如 cloud-notebooks-managed）。
  • IMAGE_FAMILY：目标映像系列的名称（例如 workbench-instances-2603）。

例如，如需将实例升级到 workbench-instances-2603 系列中的最新映像，请执行以下操作：

gcloud workbench instances upgrade example-instance \
  --location=us-central1 \
  --image-family=projects/cloud-notebooks-managed/global/images/family/workbench-instances-2603

如果省略 --image-family 标志，则实例会升级到其当前映像系列中的最新映像。

自定义容器映像

Agent Platform Workbench 实例上的自定义容器遵循严格的顺序发布模型，没有任何映像分支或并行维护。使用日期版本控制标记，该标记与用于在 Agent Platform Workbench 实例上管理自定义容器的所有映像共享，适用于任何给定版本。版本控制标记采用 YYYYMMDD-HHMM-rcX 格式。

创建基于自定义容器的实例介绍了如何在 Agent Platform Workbench 实例上构建和使用自定义容器。

主持人图片

映像系列： workbench-container-host

容器主机使用 Google 的 Container Optimized OS (COS)。创建新的 Agent Platform Workbench 自定义容器实例时，无法指定版本。新实例则使用最新的 COS 映像作为容器主机。底层映像采用 COS 的最新稳定版操作系统。请参阅 Container-Optimized OS 版本说明。

自定义容器实例

本部分介绍如何创建和升级使用自定义容器的实例。如需构建自定义容器，请参阅使用自定义容器创建实例。 如需了解基础容器映像及其规范，请参阅映像版本控制和生命周期。

使用自定义容器创建实例

如需使用自定义容器创建 Agent Platform Workbench 实例，请使用 gcloud CLI 或 Terraform。

gcloud

gcloud workbench instances create INSTANCE_NAME \
  --project=PROJECT_ID \
  --location=ZONE \
  --container-repository=REGION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/IMAGE_NAME \
  --container-tag=TAG

替换以下内容：

  • INSTANCE_NAME：实例的名称。

  • PROJECT_ID：您要在其中创建实例的 Google Cloud 项目。

  • ZONE：要在其中创建实例的可用区（例如 us-central1-a）。

  • REGION：Artifact Registry 代码库的区域（例如 us）。

  • REPOSITORY_NAME：您的 Artifact Registry 代码库的名称。

  • IMAGE_NAME：特定映像名称。如需查找可用的映像名称，请参阅映像版本说明或运行 gcloud workbench instances get-config。如需了解详情，请参阅列出可用的虚拟机映像。

  • TAG：映像标记，例如 latest。

Terraform 

resource "google_workbench_instance" "container_instance" {
  # ... other configurations
  gce_setup {
    container_image {
      repository = "REGION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/IMAGE_NAME"
      tag        = "TAG"
    }
  }
  # ...
}

升级自定义容器

自定义容器实例在两个映像上运行，这两个映像的升级方式不同：

  • 容器宿主映像：由 Google 管理。它遵循虚拟机升级路径。
  • 基础容器映像：您构建和选择的映像。如需升级，请引用可变标记（例如 :latest，实例会在重启时获取该标记的更改）或将实例更新为其他标记。

后续步骤