gke-custom-golden-image-discovery

Discovers golden base images for creating custom GKE node images from cluster configuration parameters.

19.1k|1.5k|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/google/skills --skill gke-custom-golden-image-discovery
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gke-custom-golden-image-discovery
Source: https://github.com/google/skills/tree/main/skills/cloud/gke-custom-golden-image-discovery
Command: npx skills add https://github.com/google/skills --skill gke-custom-golden-image-discovery

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Finding the correct golden base image for building custom GKE node images requires mapping many cluster parameters (GKE version, OS, architecture, accelerators, gVisor, cgroup mode) to Google's published image maps, which is tedious and error-prone when done manually.

Core Features & Use Cases

  • Parameter Inference: Translates natural-language context clues (e.g., "I need GPUs" or "hardened nodes") into technical fields like architecture, accelerator flags, and signed-module enforcement, with sensible defaults.
  • Image Map Lookup: Fetches the official GKE node-config-to-base-images JSON for the cluster's minor version and filters it by exact version and node configuration.
  • Fallback & Validation: Refines searches by toggling cgroup mode or gVisor settings when no match is found, and warns when an unsupported GKE version is provided.
  • Use Case: A platform engineer running GKE 1.34.1-gke.2909000 with H100 GPUs asks for the right base image and receives the exact image name, such as gke-1341-gke2909000-cos-125-19216-0-115-c-nvda, ready for custom node image creation.

Quick Start

Ask the agent to find the golden base image for your GKE cluster by describing your GKE version, operating system preference, and any GPU, TPU, or security requirements.

Frequently Asked Questions about gke-custom-golden-image-discovery

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find the golden base image for a custom GKE node image?

Provide your GKE version and describe your node setup, such as OS preference, GPU or TPU usage, and security requirements. The skill fetches Google's node-config-to-base-images JSON for your minor version and filters it to return the exact golden base image name.

What GKE versions support custom golden base image discovery?

The GKE version must be 1.34.1-gke.2909000 or later for the base image mapping to apply. If an unsupported or invalid version is provided, the skill warns that the version is not supported.

Does GKE golden image discovery support GPU and TPU nodes?

Yes, mentioning GPUs, TPUs, or specific hardware models like T4, A100, H100, or L4 sets the accelerator or TPU flags during lookup. The image map is then filtered to return base images built with accelerator support.

What happens if no GKE base image matches my configuration?

The skill refines the search by toggling cgroup_mode to CGROUP_MODE_V1 or disabling gVisor, then reports the adjusted result. This handles cases where the default CGROUP_MODE_V2 assumptions do not match any published image.

When should I not use GKE golden image discovery?

Do not use it for general GKE cluster creation or standard node pool management; those tasks belong to dedicated cluster-creation and GKE basics skills. It is specifically for mapping configurations to golden base images for custom node image builds.