Gerenciar versões de imagem

Esta página descreve como gerenciar versões de imagem para instâncias do Workbench da Gemini Enterprise Agent Platform, incluindo como fazer o seguinte:

  • Listar os nomes de imagem disponíveis
  • Criar uma instância em um nome de imagem específico
  • Fazer upgrade ou mover uma instância entre famílias de imagens

Para saber mais sobre o esquema de controle de versões, o conteúdo da imagem e o ciclo de vida, consulte Controle de versões e ciclo de vida de imagens.

Para saber o que mudou em cada versão, consulte Notas da versão da imagem.

Imagens de VM

Esta seção descreve como listar imagens de VM disponíveis, criar uma instância em uma imagem de VM específica e fazer upgrade da imagem de VM de uma instância.

Listar imagens de VM disponíveis

As imagens de VM são armazenadas em um repositório particular. Para listar as imagens de VM disponíveis e as configurações compatíveis, use gcloud workbench instances get-config ou a API GetConfig.

gcloud 

gcloud workbench instances get-config --location=LOCATION

Substitua LOCATION pela Cloud de Confiance by S3NS região, por exemplo, 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"

Substitua:

  • PROJECT_ID: o ID do Cloud de Confiance by S3NS projeto.
  • LOCATION: a região em que você quer recuperar as configurações.

Criar uma instância com uma imagem de VM específica

Para criar uma instância em uma imagem de VM específica, use a CLI gcloud ou o Terraform. É possível especificar uma família de imagens para receber o nome da imagem mais recente ou especificar um nome de imagem para receber a versão exata.

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

Substitua:

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

Fazer upgrade de uma imagem de VM

Por padrão, uma instância é atualizada para o nome de imagem mais recente na família de imagens atual. Para usar um nome de imagem mais antigo, crie uma nova instância com um nome de imagem específico.

gcloud 

gcloud workbench instances upgrade INSTANCE_NAME --location=LOCATION

Substitua:

  • INSTANCE_NAME: o nome da instância.
  • LOCATION: a região em que a instância está localizada.

Terraform

Na configuração do Terraform, defina o bloco vm_image no 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 mais informações sobre como criar uma instância com uma versão específica, consulte Criar uma versão específica.

Fazer upgrade entre famílias de imagens

Para mudar uma instância para o nome de imagem mais recente em uma família de imagens diferente (por exemplo, de workbench-instances para workbench-instances-2603), especifique a família de imagens de destino durante o upgrade. Esse é o caminho compatível para mudar entre versões principais sem recriar a instância.

gcloud

Use a flag --image-family com gcloud workbench instances upgrade para especificar a família de imagens de destino. A instância é atualizada para a imagem mais recente na família especificada.

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

Substitua:

  • INSTANCE_NAME: o nome da instância.
  • LOCATION: a região em que a instância está localizada.
  • IMAGE_PROJECT: o projeto que hospeda a família de imagens (por exemplo, cloud-notebooks-managed).
  • IMAGE_FAMILY: o nome da família de imagens de destino (por exemplo, workbench-instances-2603).

Por exemplo, para fazer upgrade de uma instância para a imagem mais recente na família workbench-instances-2603:

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

Se a flag --image-family for omitida, a instância será atualizada para a imagem mais recente na família de imagens atual.

Imagem de contêiner personalizada

Os contêineres personalizados em instâncias do Workbench da Agent Platform seguem um modelo de lançamento estritamente sequencial, sem ramificação de imagem ou manutenção paralela. Uma tag de controle de versões de data é usada e compartilhada com todas as imagens usadas para gerenciar contêineres personalizados em instâncias do Workbench da Agent Platform para qualquer versão. A tag de controle de versões segue o formato YYYYMMDD-HHMM-rcX.

Criar uma instância baseada em contêiner personalizado descreve como criar e usar contêineres personalizados em instâncias do Agent Platform Workbench.

Imagem do host

Família de imagens:workbench-container-host

O host do contêiner usa o SO otimizado para contêineres (COS, na sigla em inglês) do Google. A versão não pode ser especificada ao criar uma nova instância de contêiner personalizado do Agent Platform Workbench. Em vez disso, novas instâncias usam a imagem do COS mais recente como host do contêiner. A imagem subjacente segue a versão mais recente e estável do SO do COS. Consulte as notas da versão do Container-Optimized OS.

Instâncias de contêiner personalizado

Esta seção aborda a criação e o upgrade de instâncias que usam contêineres personalizados. Para criar um contêiner personalizado, consulte Criar uma instância usando um contêiner personalizado. Para as imagens de contêiner base e as especificações delas, consulte Controle de versões e ciclo de vida de imagens.

Criar uma instância com um contêiner personalizado

Para criar uma instância do Workbench da Agent Platform usando um contêiner personalizado, use a CLI gcloud ou 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

Substitua:

  • INSTANCE_NAME: o nome da instância.

  • PROJECT_ID: o Cloud de Confiance by S3NS projeto em que você quer criar a instância.

  • ZONE: a zona em que você quer criar a instância (por exemplo, us-central1-a).

  • REGION: a região do repositório do Artifact Registry (por exemplo, us).

  • REPOSITORY_NAME: o nome do repositório do Artifact Registry.

  • IMAGE_NAME: um nome de imagem específico. Para encontrar nomes de imagem disponíveis, consulte Notas da versão da imagem ou execute gcloud workbench instances get-config. Para mais informações, consulte Listar imagens de VM disponíveis.

  • TAG: a tag de imagem, por exemplo, 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"
    }
  }
  # ...
}

Fazer upgrade de um contêiner personalizado

Uma instância de contêiner personalizado é executada em duas imagens, que são atualizadas de maneira diferente:

  • Imagem do host do contêiner:gerenciada pelo Google. Ela segue o caminho de upgrade da VM.
  • Imagem do contêiner base:a imagem que você cria e seleciona. Para fazer upgrade dela, faça referência a uma tag mutável, como :latest (a instância coleta as mudanças nessa tag na reinicialização) ou atualize a instância para uma tag diferente.

A seguir