Mengelola versi image

Halaman ini menjelaskan cara mengelola versi image untuk instance Agent Platform Workbench Gemini Enterprise, termasuk cara melakukan hal berikut:

• Mencantumkan nama image yang tersedia
• Membuat instance dengan nama image tertentu
• Mengupgrade atau memindahkan instance antar-kelompok image

Untuk mempelajari skema pembuatan versi, konten image, dan siklus proses, lihat Pembuatan versi dan siklus proses image.

Untuk mempelajari perubahan di setiap rilis, lihat Catatan rilis image.

Image VM

Bagian ini menjelaskan cara mencantumkan image VM yang tersedia, membuat instance dengan image VM tertentu, dan mengupgrade image VM instance.

Mencantumkan image VM yang tersedia

Image VM disimpan di repositori pribadi. Untuk mencantumkan image VM yang tersedia dan konfigurasi yang didukung, gunakan gcloud workbench instances get-config atau GetConfig API.

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"

Membuat instance dengan image VM tertentu

Untuk membuat instance dengan image VM tertentu, gunakan gcloud CLI atau Terraform. Anda dapat menentukan kelompok image untuk mendapatkan nama image terbarunya, atau menentukan nama image untuk mendapatkan versi yang tepat.

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

Mengupgrade image VM

Secara default, instance akan diupgrade ke nama image terbaru dalam kelompok image saat ini. Untuk menggunakan nama image yang lebih lama, buat instance baru dari nama image tertentu.

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

Mengupgrade antar-kelompok image

Untuk mengubah instance ke nama image terbaru dalam kelompok image yang berbeda (misalnya, dari workbench-instances ke workbench-instances-2603 yang lebih baru), tentukan kelompok image target selama upgrade. Ini adalah jalur yang didukung untuk mengubah antar-versi utama tanpa membuat ulang instance.

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

Image container kustom

Container kustom pada instance Agent Platform Workbench mengikuti model rilis yang sangat berurutan tanpa cabang image atau pemeliharaan paralel. Tag pembuatan versi tanggal digunakan, yang dibagikan ke semua image yang digunakan untuk mengelola container kustom pada instance Agent Platform Workbench untuk rilis tertentu. Tag pembuatan versi mengikuti format YYYYMMDD-HHMM-rcX.

Membuat instance berbasis container kustom menjelaskan cara membuat dan menggunakan container kustom pada instance Agent Platform Workbench.

Image host

Kelompok image: workbench-container-host

Host container menggunakan Container Optimized OS (COS) Google. Versi tidak dapat ditentukan saat membuat instance container kustom Agent Platform Workbench baru. Sebagai gantinya, instance baru menggunakan image COS terbaru sebagai host container. Image yang mendasarinya mengikuti versi OS stabil terbaru dari COS. Lihat Catatan rilis Container-Optimized OS.

Instance container kustom

Bagian ini membahas cara membuat dan mengupgrade instance yang menggunakan container kustom. Untuk membuat container kustom, lihat membuat instance menggunakan container kustom. Untuk image container dasar dan spesifikasinya, lihat Pembuatan versi dan siklus proses image.

Membuat instance dengan container kustom

Untuk membuat instance Agent Platform Workbench menggunakan container kustom, gunakan gcloud CLI atau 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"
    }
  }
  # ...
}

Mengupgrade container kustom

Instance container kustom berjalan pada dua image, yang diupgrade secara berbeda:

• Image host container: dikelola oleh Google. Image ini mengikuti jalur upgrade VM .
• Image Container dasar: image yang Anda buat dan pilih. Untuk mengupgrade-nya, referensikan tag yang dapat diubah seperti :latest (instance mengambil perubahan pada tag tersebut saat dimulai ulang) atau update instance ke tag yang berbeda.

Langkah berikutnya

• Pembuatan versi dan siklus proses image: Lihat konten setiap image, cara penomoran versi, dan kapan image tidak digunakan lagi.
• Catatan rilis image: Lihat perubahan di setiap rilis image.
• Kebijakan dukungan: Pelajari penanganan CVE, paket, periode dukungan, dan pemberitahuan penghentian penggunaan.