Administra las versiones de imágenes

En esta página, se describe cómo administrar las versiones de imágenes para las instancias de Agent Platform Workbench de Gemini Enterprise Agent Platform, incluido cómo hacer lo siguiente:

  • Enumera los nombres de imágenes disponibles.
  • Crea una instancia con un nombre de imagen específico.
  • Actualiza o mueve una instancia entre familias de imágenes.

Para obtener información sobre el esquema de control de versiones, el contenido de las imágenes y el ciclo de vida, consulta Control de versiones y ciclo de vida de las imágenes.

Para obtener información sobre los cambios en cada versión, consulta las notas de la versión de las imágenes.

Imágenes de VM

En esta sección, se describe cómo enumerar las imágenes de VM disponibles, crear una instancia en una imagen de VM específica y actualizar la imagen de VM de una instancia.

Enumera las imágenes de VM disponibles

Las imágenes de VM se almacenan en un repositorio privado. Para enumerar las imágenes de VM disponibles y sus configuraciones compatibles, usa gcloud workbench instances get-config o la API de GetConfig.

gcloud 

gcloud workbench instances get-config --location=LOCATION

Reemplaza LOCATION por la Cloud de Confiance by S3NS región, por ejemplo, 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"

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del Cloud de Confiance by S3NS proyecto de.
  • LOCATION: Es la región en la que deseas recuperar las configuraciones.

Crea una instancia con una imagen de VM específica

Para crear una instancia en una imagen de VM específica, usa gcloud CLI o Terraform. Puedes especificar una familia de imágenes para obtener su nombre de imagen más reciente o especificar un nombre de imagen para obtener la versión exacta.

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

Reemplaza lo siguiente:

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
    }
  }
  # ...
}

Actualiza una imagen de VM

De forma predeterminada, una instancia se actualiza al nombre de imagen más reciente de su familia de imágenes actual. Para usar un nombre de imagen anterior, crea una instancia nueva a partir de un nombre de imagen específico.

gcloud 

gcloud workbench instances upgrade INSTANCE_NAME --location=LOCATION

Reemplaza lo siguiente:

  • INSTANCE_NAME: el nombre de tu instancia
  • LOCATION: la región en la que se encuentra tu instancia

Terraform

En la configuración de Terraform, establece el bloque vm_image dentro del recurso google_workbench_instance.

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

Para obtener más información sobre cómo crear una instancia con una versión específica, consulta Crea una versión específica.

Actualiza entre familias de imágenes

Para cambiar una instancia al nombre de imagen más reciente en una familia de imágenes diferente (por ejemplo, de workbench-instances a la más reciente workbench-instances-2603), especifica la familia de imágenes de destino durante la actualización. Esta es la ruta de acceso compatible para cambiar entre versiones principales sin volver a crear la instancia.

gcloud

Usa la marca --image-family con gcloud workbench instances upgrade para especificar la familia de imágenes de destino. La instancia se actualiza a la imagen más reciente de la familia especificada.

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

Reemplaza lo siguiente:

  • INSTANCE_NAME: el nombre de tu instancia
  • LOCATION: la región en la que se encuentra tu instancia
  • IMAGE_PROJECT: el proyecto que aloja la familia de imágenes (por ejemplo, cloud-notebooks-managed)
  • IMAGE_FAMILY: el nombre de la familia de imágenes de destino (por ejemplo, workbench-instances-2603)

Por ejemplo, para actualizar una instancia a la imagen más reciente de la familia workbench-instances-2603, haz lo siguiente:

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

Si se omite la marca --image-family, la instancia se actualiza a la imagen más reciente de su familia de imágenes actual.

Imagen de contenedor personalizada

Los contenedores personalizados en las instancias de Agent Platform Workbench siguen un modelo de lanzamiento estrictamente secuencial sin ninguna bifurcación de imágenes ni mantenimiento paralelo. Se usa una etiqueta de control de versiones de fecha, que se comparte con todas las imágenes que se usan para administrar contenedores personalizados en instancias de Agent Platform Workbench para cualquier versión determinada. La etiqueta de control de versiones sigue el formato YYYYMMDD-HHMM-rcX.

En Crea una instancia basada en un contenedor personalizado, se describe cómo compilar y utilizar contenedores personalizados en instancias de Agent Platform Workbench.

Imagen del host

Familia de imágenes: workbench-container-host

El host del contenedor usa Container-Optimized OS (COS) de Google. No se puede especificar la versión cuando se crea una instancia de contenedor personalizado nueva de Agent Platform Workbench. En cambio, las instancias nuevas usan la imagen de COS más reciente como host del contenedor. La imagen subyacente sigue la versión estable más reciente del SO de COS. Consulta las notas de la versión de Container-Optimized OS.

Instancias de contenedores personalizados

En esta sección, se explica cómo crear y actualizar instancias que usan contenedores personalizados. Para compilar un contenedor personalizado, consulta Crea una instancia con un contenedor personalizado. Para obtener las imágenes de contenedor base y sus especificaciones, consulta Control de versiones y ciclo de vida de las imágenes.

Crea una instancia con un contenedor personalizado

Para crear una instancia de Agent Platform Workbench con un contenedor personalizado, usa gcloud CLI o 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

Reemplaza lo siguiente:

  • INSTANCE_NAME: el nombre de tu instancia

  • PROJECT_ID: el Cloud de Confiance by S3NS proyecto en el que deseas crear la instancia.

  • ZONE: la zona en la que deseas crear la instancia (por ejemplo, us-central1-a)

  • REGION: la región del repositorio de Artifact Registry (por ejemplo, us)

  • REPOSITORY_NAME: el nombre de tu repositorio de Artifact Registry

  • IMAGE_NAME: un nombre de imagen específico Para encontrar nombres de imágenes disponibles, consulta las notas de la versión de las imágenes o ejecuta gcloud workbench instances get-config. Para obtener más información, consulta Enumera las imágenes de VM disponibles.

  • TAG: la etiqueta de imagen, por ejemplo, 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"
    }
  }
  # ...
}

Actualiza un contenedor personalizado

Una instancia de contenedor personalizado se ejecuta en dos imágenes, que se actualizan de manera diferente:

  • Imagen del host del contenedor: administrada por Google. Sigue la ruta de actualización de la VM.
  • Imagen del contenedor base: la imagen que compilas y seleccionas. Para actualizarla, haz referencia a una etiqueta mutable, como :latest (la instancia toma los cambios en esa etiqueta cuando se reinicia) o actualiza la instancia a una etiqueta diferente.

¿Qué sigue?