이미지 버전 관리

이 페이지에서는 Gemini Enterprise Agent Platform Workbench 인스턴스의 이미지 버전을 관리하는 방법을 설명합니다. 여기에는 다음 작업 방법이 포함됩니다.

• 사용 가능한 이미지 이름 나열
• 특정 이미지 이름으로 인스턴스 만들기
• 이미지 계열 간에 인스턴스 업그레이드 또는 이동

버전 관리 스키마, 이미지 콘텐츠, 수명 주기에 대한 자세한 내용은 이미지 버전 관리 및 수명 주기를 참고하세요.

각 출시 버전에서 변경된 사항을 알아보려면 이미지 출시 노트를 참고하세요.

VM 이미지

이 섹션에서는 사용 가능한 VM 이미지를 나열하고, 특정 VM 이미지에서 인스턴스를 만들고, 인스턴스의 VM 이미지를 업그레이드하는 방법을 설명합니다.

사용 가능한 VM 이미지 나열

VM 이미지는 비공개 저장소에 저장됩니다. 사용 가능한 VM 이미지와 지원되는 구성을 나열하려면 gcloud workbench instances get-config 또는 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"

특정 VM 이미지로 인스턴스 만들기

특정 VM 이미지에서 인스턴스를 만들려면 gcloud CLI 또는 Terraform을 사용하세요. 이미지 계열을 지정하여 최신 이미지 이름을 가져오거나 이미지 이름을 지정하여 정확한 버전을 가져올 수 있습니다.

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

VM 이미지 업그레이드

기본적으로 인스턴스는 현재 이미지 계열의 최신 이미지 이름으로 업그레이드됩니다. 이전 이미지 이름을 사용하려면 특정 이미지 이름으로 새 인스턴스를 만드세요.

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

이미지 계열 간 업그레이드

인스턴스를 다른 이미지 계열의 최신 이미지 이름으로 변경하려면 (예: workbench-instances에서 최신 workbench-instances-2603으로) 업그레이드 중에 대상 이미지 계열을 지정하세요. 인스턴스를 다시 만들지 않고 주 버전 간에 변경하는 데 지원되는 경로입니다.

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

커스텀 컨테이너 이미지

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의 최신 안정적인 OS 버전을 따릅니다. Container-Optimized OS 출시 노트를 참고하세요.

커스텀 컨테이너 인스턴스

이 섹션에서는 커스텀 컨테이너를 사용하는 인스턴스를 만들고 업그레이드하는 방법을 설명합니다. 커스텀 컨테이너를 빌드하려면 커스텀 컨테이너를 사용하여 인스턴스 만들기를 참고하세요. 기본 컨테이너 이미지 및 사양은 이미지 버전 관리 및 수명 주기를 참고하세요.

커스텀 컨테이너로 인스턴스 만들기

커스텀 컨테이너를 사용하여 Agent Platform Workbench 인스턴스를 만들려면 gcloud CLI 또는 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"
    }
  }
  # ...
}

커스텀 컨테이너 업그레이드

커스텀 컨테이너 인스턴스는 두 개의 이미지에서 실행되며, 이 이미지는 다르게 업그레이드됩니다.

• 컨테이너 호스트 이미지: Google에서 관리합니다. VM 업그레이드 경로를 따릅니다.
• 기본 컨테이너 이미지: 빌드하고 선택하는 이미지입니다. 업그레이드하려면 :latest와 같은 변경 가능한 태그를 참조하거나 (인스턴스가 다시 시작될 때 해당 태그의 변경사항을 선택함) 인스턴스를 다른 태그로 업데이트합니다.

다음 단계

• 이미지 버전 관리 및 수명 주기: 각 이미지에 포함된 내용, 버전 번호 지정 방법, 이미지가 지원 중단되는 시기를 확인합니다.
• 이미지 출시 노트: 각 이미지 출시 버전에서 변경된 사항을 확인합니다.
• 지원 정책: CVE 처리, 패키지, 지원 기간, 지원 중단 알림에 대해 알아봅니다.