イメージ バージョンを管理する

このページでは、Gemini Enterprise Agent Platform Workbench インスタンスのイメージ バージョンを管理する方法について説明します。次の操作を行う方法について説明します。

  • 使用可能なイメージ名を一覧表示する
  • 特定のイメージ名でインスタンスを作成する
  • イメージ ファミリー間でインスタンスをアップグレードまたは移動する

バージョニング スキーム、イメージの内容、ライフサイクルについては、イメージのバージョニングとライフサイクルをご覧ください。

各リリースの変更点については、イメージのリリースノートをご覧ください。

VM イメージ

このセクションでは、使用可能な VM イメージを一覧表示する方法、特定の VM イメージにインスタンスを作成する方法、インスタンスの VM イメージをアップグレードする方法について説明します。

利用可能な VM イメージを一覧表示する

VM イメージは非公開リポジトリに保存されます。使用可能な VM イメージとそのサポートされている構成を一覧表示するには、gcloud workbench instances get-config または GetConfig API を使用します。

gcloud

gcloud workbench instances get-config --location=LOCATION

LOCATION は、 Cloud de Confiance by S3NS リージョン（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"

次のように置き換えます。

  • PROJECT_ID: 実際の Cloud de Confiance by S3NS プロジェクト ID。
  • LOCATION: 構成を取得するリージョン。

特定の VM イメージを使用してインスタンスを作成する

特定の VM イメージにインスタンスを作成するには、gcloud CLI または Terraform を使用します。イメージ ファミリーを指定して最新のイメージ名を取得するか、イメージ名を指定して正確なバージョンを取得できます。

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

次のように置き換えます。

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

VM イメージをアップグレードする

デフォルトでは、インスタンスは現在のイメージ ファミリーの最新のイメージ名にアップグレードされます。古いイメージ名を使用するには、特定のイメージ名から新しいインスタンスを作成します。

gcloud

gcloud workbench instances upgrade INSTANCE_NAME --location=LOCATION

次のように置き換えます。

  • INSTANCE_NAME: インスタンスの名前。
  • LOCATION: インスタンスが配置されているリージョン。

Terraform

Terraform 構成で、google_workbench_instance リソース内に vm_image ブロックを設定します。

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

gcloud workbench instances upgrade で --image-family フラグを使用して、ターゲット イメージ ファミリーを指定します。インスタンスは、指定されたファミリーの最新のイメージにアップグレードされます。

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

次のように置き換えます。

  • INSTANCE_NAME: インスタンスの名前。
  • LOCATION: インスタンスが配置されているリージョン。
  • IMAGE_PROJECT: イメージ ファミリーをホストするプロジェクト（例: cloud-notebooks-managed）。
  • IMAGE_FAMILY: ターゲット イメージ ファミリーの名前（workbench-instances-2603 など）。

たとえば、インスタンスを workbench-instances-2603 ファミリーの最新のイメージにアップグレードするには:

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

--image-family フラグが省略されている場合、インスタンスは現在のイメージ ファミリーの最新のイメージにアップグレードされます。

カスタム コンテナ イメージ

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

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

次のように置き換えます。

  • INSTANCE_NAME: インスタンスの名前。

  • PROJECT_ID: インスタンスを作成する Cloud de Confiance by S3NS プロジェクト。

  • ZONE: インスタンスを作成するゾーン（us-central1-a など）。

  • REGION: Artifact Registry リポジトリのリージョン（例: us）。

  • REPOSITORY_NAME: Artifact Registry リポジトリの名前。

  • IMAGE_NAME: 特定のイメージ名。使用可能なイメージ名を確認するには、イメージのリリースノートをご覧になるか、gcloud workbench instances get-config を実行します。詳細については、利用可能な VM イメージを一覧表示するをご覧ください。

  • TAG: イメージタグ（例: 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"
    }
  }
  # ...
}

カスタム コンテナをアップグレードする

カスタム コンテナ インスタンスは、アップグレード方法が異なる 2 つのイメージで実行されます。

  • コンテナ ホスト イメージ: Google によって管理されます。VM アップグレード パスに従います。
  • ベース コンテナ イメージ: ビルドして選択したイメージ。アップグレードするには、:latest などの可変タグを参照するか（インスタンスは再起動時にそのタグの変更を反映します）、インスタンスを別のタグに更新します。

次のステップ