Gestire le versioni delle immagini

Questa pagina descrive come gestire le versioni delle immagini per le istanze Workbench di Gemini Enterprise Agent Platform, incluso come:

• Elencare i nomi delle immagini disponibili
• Creare un'istanza con un nome immagine specifico
• Eseguire l'upgrade o spostare un'istanza tra famiglie di immagini

Per scoprire di più sullo schema di controllo delle versioni, sui contenuti delle immagini e sul ciclo di vita, consulta Controllo delle versioni e ciclo di vita delle immagini.

Per scoprire di più sulle modifiche apportate a ogni release, consulta le note di rilascio delle immagini.

Immagini VM

Questa sezione descrive come elencare le immagini VM disponibili, creare un'istanza su un'immagine VM specifica ed eseguire l'upgrade dell'immagine VM di un'istanza.

Elencare le immagini VM disponibili

Le immagini VM sono archiviate in un repository privato. Per elencare le immagini VM disponibili e le relative configurazioni supportate, utilizza gcloud workbench instances get-config o l'API GetConfig.

gcloud workbench instances get-config --location=LOCATION

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

Creare un'istanza con un'immagine VM specifica

Per creare un'istanza su un'immagine VM specifica, utilizza gcloud CLI o Terraform. Puoi specificare una famiglia di immagini per ottenere il nome dell'immagine più recente o specificare un nome immagine per ottenere la versione esatta.

# 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

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

Eseguire l'upgrade di un'immagine VM

Per impostazione predefinita, un'istanza esegue l'upgrade al nome dell'immagine più recente nella famiglia di immagini corrente. Per utilizzare un nome immagine precedente, crea una nuova istanza da un nome immagine specifico.

gcloud workbench instances upgrade INSTANCE_NAME --location=LOCATION

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

Eseguire l'upgrade tra famiglie di immagini

Per modificare un'istanza con il nome dell'immagine più recente in una famiglia di immagini diversa (per esempio, da workbench-instances alla più recente workbench-instances-2603), specifica la famiglia di immagini di destinazione durante l'upgrade. Questo è il percorso supportato per passare da una versione principale all'altra senza ricreare l'istanza.

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

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

Immagine container personalizzata

I container personalizzati sulle istanze Workbench di Agent Platform seguono un modello di release strettamente sequenziale senza ramificazioni di immagini o manutenzione parallela. Viene utilizzato un tag di controllo delle versioni della data, condiviso con tutte le immagini utilizzate per gestire i container personalizzati sulle istanze Workbench di Agent Platform per una determinata release. Il tag di controllo delle versioni segue il formato YYYYMMDD-HHMM-rcX.

Creare un'istanza basata su container personalizzati descrive come creare e utilizzare container personalizzati sulle istanze Workbench di Agent Platform.

Immagine host

Famiglia di immagini: workbench-container-host

L'host del container utilizza Container-Optimized OS (COS) di Google. Non è possibile specificare la versione quando si crea una nuova istanza di container personalizzato di Agent Platform Workbench. Al contrario, le nuove istanze utilizzano l'immagine COS più recente come host del container. L'immagine sottostante segue la versione del sistema operativo stabile più recente di COS. Consulta le note di rilascio di Container-Optimized OS.

Istanze di container personalizzati

Questa sezione illustra la creazione e l'upgrade delle istanze che utilizzano container personalizzati. Per creare un container personalizzato, consulta Creare un'istanza utilizzando un container personalizzato. Per le immagini container di base e le relative specifiche, consulta Controllo delle versioni e ciclo di vita delle immagini.

Creare un'istanza con un container personalizzato

Per creare un'istanza Workbench di Agent Platform utilizzando un container personalizzato, utilizza gcloud CLI o Terraform.

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

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

Eseguire l'upgrade di un container personalizzato

Un'istanza di container personalizzato viene eseguita su due immagini, che vengono sottoposte all'upgrade in modo diverso:

• Immagine host del container: gestita da Google. Segue il percorso di upgrade della VM.
• Immagine container di base: l'immagine che crei e selezioni. Per eseguire l'upgrade, fai riferimento a un tag modificabile come :latest (l'istanza rileva le modifiche apportate a questo tag al riavvio) o aggiorna l'istanza a un tag diverso.

Passaggi successivi

• Controllo delle versioni e ciclo di vita delle immagini: scopri cosa contiene ogni immagine, come vengono numerate le versioni e quando le immagini vengono ritirate.
• Note di rilascio delle immagini: Scopri le modifiche apportate a ogni release delle immagini.
• Policy di assistenza: scopri di più sulla gestione delle CVE, sui pacchetti, sulle finestre di assistenza e sull'avviso di ritiro.