Image-Versionen verwalten

Auf dieser Seite wird beschrieben, wie Sie Image-Versionen für Gemini Enterprise Agent Platform Workbench-Instanzen verwalten. Dazu gehören folgende Aufgaben:

  • Verfügbare Image-Namen auflisten
  • Instanz mit einem bestimmten Image-Namen erstellen
  • Instanz zwischen Image-Familien upgraden oder verschieben

Informationen zum Versionsschema, zu Image-Inhalten und zum Lebenszyklus finden Sie unter Image-Versionsverwaltung und -Lebenszyklus.

Informationen zu den Änderungen in den einzelnen Releases finden Sie in den Versionshinweisen zu Images.

VM-Images

In diesem Abschnitt wird beschrieben, wie Sie verfügbare VM-Images auflisten, eine Instanz mit einem bestimmten VM-Image erstellen und das VM-Image einer Instanz upgraden.

Verfügbare VM-Images auflisten

VM-Images werden in einem privaten Repository gespeichert. Verwenden Sie gcloud workbench instances get-config oder die GetConfig API, um verfügbare VM-Images und ihre unterstützten Konfigurationen aufzulisten.

gcloud 

gcloud workbench instances get-config --location=LOCATION

Ersetzen Sie LOCATION durch die Cloud de Confiance by S3NS Region, z. B. 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"

Ersetzen Sie Folgendes:

  • PROJECT_ID: Ihre Cloud de Confiance by S3NS Projekt-ID.
  • LOCATION: die Region, in der Sie Konfigurationen abrufen möchten.

Instanz mit einem bestimmten VM-Image erstellen

Verwenden Sie die gcloud CLI oder Terraform, um eine Instanz mit einem bestimmten VM-Image zu erstellen. Sie können eine Image-Familie angeben, um den neuesten Image-Namen zu erhalten, oder einen Image-Namen angeben, um die genaue Version zu erhalten.

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

Ersetzen Sie Folgendes:

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-Image upgraden

Standardmäßig wird eine Instanz auf den neuesten Image-Namen in der aktuellen Image-Familie aktualisiert. Wenn Sie einen älteren Image-Namen verwenden möchten, erstellen Sie eine neue Instanz mit einem bestimmten Image-Namen.

gcloud 

gcloud workbench instances upgrade INSTANCE_NAME --location=LOCATION

Ersetzen Sie Folgendes:

  • INSTANCE_NAME: Der Name der Instanz.
  • LOCATION: Die Region, in der sich die Instanz befindet.

Terraform

Legen Sie in der Terraform-Konfiguration den Block vm_image in der Ressource google_workbench_instance fest.

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

Weitere Informationen zum Erstellen einer Instanz mit einer bestimmten Version finden Sie unter Bestimmte Version erstellen.

Upgrade über Image-Familien hinweg

Wenn Sie eine Instanz auf den neuesten Image-Namen in einer anderen Image-Familie umstellen möchten (z. B. von workbench-instances auf das neuere workbench-instances-2603), geben Sie beim Upgrade die Ziel-Image-Familie an. Dies ist der unterstützte Weg, um zwischen Hauptversionen zu wechseln, ohne die Instanz neu zu erstellen.

gcloud

Verwenden Sie das Flag --image-family mit gcloud workbench instances upgrade, um die Ziel-Image-Familie anzugeben. Die Instanz wird auf das neueste Image in der angegebenen Familie aktualisiert.

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

Ersetzen Sie Folgendes:

  • INSTANCE_NAME: Der Name der Instanz.
  • LOCATION: Die Region, in der sich die Instanz befindet.
  • IMAGE_PROJECT: Das Projekt, das die Image-Familie hostet (z. B. cloud-notebooks-managed).
  • IMAGE_FAMILY: Der Name der Ziel-Image-Familie (z. B. workbench-instances-2603).

So upgraden Sie beispielsweise eine Instanz auf das neueste Image in der Familie workbench-instances-2603:

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

Wenn das Flag --image-family weggelassen wird, wird die Instanz auf das neueste Image in der aktuellen Image-Familie aktualisiert.

Benutzerdefiniertes Container-Image

Benutzerdefinierte Container auf Agent Platform Workbench-Instanzen folgen einem streng sequenziellen Release-Modell ohne Image-Verzweigung oder parallele Wartung. Es wird ein Versions-Tag mit Datum verwendet, das für alle Images gilt, die zum Verwalten benutzerdefinierter Container auf Agent Platform Workbench-Instanzen für ein bestimmtes Release verwendet werden. Das Versions-Tag hat das Format YYYYMMDD-HHMM-rcX.

Unter Instanz mit benutzerdefiniertem Container erstellen wird beschrieben, wie Sie benutzerdefinierte Container auf Agent Platform Workbench-Instanzen erstellen und verwenden.

Host-Image

Image-Familie:workbench-container-host

Der Container-Host verwendet Container-Optimized OS (COS) von Google. Die Version kann beim Erstellen einer neuen benutzerdefinierten Agent Platform Workbench-Container-Instanz nicht angegeben werden. Stattdessen verwenden neue Instanzen das neueste COS-Image als Container-Host. Das zugrunde liegende Image folgt der neuesten stabilen Betriebssystemversion von COS. Weitere Informationen finden Sie in den Versionshinweisen zu Container-Optimized OS.

Benutzerdefinierte Container-Instanzen

In diesem Abschnitt wird beschrieben, wie Sie Instanzen erstellen und upgraden, die benutzerdefinierte Container verwenden. Informationen zum Erstellen eines benutzerdefinierten Containers finden Sie unter Instanz mit einem benutzerdefinierten Container erstellen. Informationen zu den Basis-Container-Images und ihren Spezifikationen finden Sie unter Image-Versionsverwaltung und -Lebenszyklus.

Instanz mit einem benutzerdefinierten Container erstellen

Verwenden Sie die gcloud CLI oder Terraform, um eine Agent Platform Workbench-Instanz mit einem benutzerdefinierten Container zu erstellen.

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

Ersetzen Sie Folgendes:

  • INSTANCE_NAME: Der Name der Instanz.

  • PROJECT_ID: das Cloud de Confiance by S3NS Projekt, in dem Sie die Instanz erstellen möchten.

  • ZONE: Die Zone, in der Sie die Instanz erstellen möchten (z. B. us-central1-a).

  • REGION: Die Region für das Artifact Registry-Repository (z. B. us).

  • REPOSITORY_NAME: Der Name Ihres Artifact Registry-Repositorys.

  • IMAGE_NAME: Ein bestimmter Image-Name. Verfügbare Image-Namen finden Sie in den Versionshinweisen zu Images oder indem Sie gcloud workbench instances get-config ausführen. Weitere Informationen finden Sie unter Verfügbare VM-Images auflisten.

  • TAG: Das Image-Tag, z. B. 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"
    }
  }
  # ...
}

Benutzerdefinierten Container upgraden

Eine benutzerdefinierte Container-Instanz wird auf zwei Images ausgeführt, die unterschiedlich aktualisiert werden:

  • Container-Host-Image:von Google verwaltet. Es folgt dem VM-Upgrade-Pfad.
  • Basis-Container-Image:Das Image, das Sie erstellen und auswählen. Wenn Sie es upgraden möchten, verweisen Sie entweder auf ein veränderliches Tag wie :latest (die Instanz übernimmt die Änderungen an diesem Tag beim Neustart) oder aktualisieren Sie die Instanz auf ein anderes Tag.

Nächste Schritte