{
  "slug": "gcloud-workbench-instances-upgrade-accepts-image-family-0c9a569d910a",
  "title": "gcloud workbench instances upgrade accepts --image-family",
  "tools": [
    "gcloud"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-06-09T00:00:00.000Z",
  "announced_at": "2026-06-09T00:00:00.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "To upgrade a Workbench instance to the latest image in a different family, pass that family's full Compute Engine resource name with `--image-family`.",
    "examples": [
      "gcloud workbench instances upgrade <INSTANCE_NAME> --location=<LOCATION> --image-family=projects/<IMAGE_PROJECT>/global/images/family/<IMAGE_FAMILY>"
    ],
    "gotchas": [
      "INSTANCE_NAME (required): Name of the instance.",
      "--location (required): Google Cloud location of the environment.",
      "--image-family: Full resource name in `projects/{project_id}/global/images/family/{image_family}` format; selects the latest image in that family and allows upgrades across families.",
      "IMAGE_PROJECT (required): Project hosting the image family.",
      "IMAGE_FAMILY (required): Target image family name."
    ]
  },
  "why_it_matters": "Select an image family when upgrading a Workbench instance.",
  "before": "If `--image-family` is omitted, the instance upgrades to the latest image in its current image family.",
  "sources": [
    "https://docs.cloud.google.com/sdk/docs/release-notes#57200_2026-06-09",
    "https://docs.cloud.google.com/gemini-enterprise-agent-platform/notebooks/workbench/instances/manage-image-versions",
    "https://docs.cloud.google.com/sdk/gcloud/reference/workbench/instances/upgrade"
  ],
  "rank": 0.92021,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v1+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "cloud-20261008",
    "verdict_id": "cloud-20261008:cloud-20261008-70eb0210fae40949-9:gate",
    "evidence_hash": "8bc572002c64626edce83e077c76f5b67a64b8b509cc0e0bac1da79bbdd21a83"
  },
  "review": {
    "draft_hash": "2eeb6a2801d81959de3397f2c83d8a27d5b06951dfb82fc1c3822732a44fc2ef",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "cloud-20261008:gate",
    "reason": "2 of 3 judge runs approved with p_yes >= 0.9 (mean 0.92 >= 0.9; 2 needed) and Jev gave 0.60 (>= 0.6 needed)."
  }
}