gke-upgrades

Plans, executes, and troubleshoots GKE cluster upgrades and maintenance operations.

Updated May 11, 2026
One-click install
npx skills add https://github.com/alon3153/upe-social-publisher --skill gke-upgrades-alon3153
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gke-upgrades
Source: https://github.com/alon3153/upe-social-publisher/tree/main/.agents/skills/gke-upgrades
Command: npx skills add https://github.com/alon3153/upe-social-publisher --skill gke-upgrades-alon3153

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Upgrading GKE clusters involves version compatibility checks, node pool strategy selection, maintenance window coordination, and failure diagnosis — mistakes cause downtime or stuck rollouts. This Skill produces tailored upgrade plans, runbooks, and checklists for Standard and Autopilot clusters. ## Core Features & Use Cases - Upgrade Planning: Generates version compatibility analysis, sequential upgrade paths, and node pool strategies (surge, blue-green, autoscaled blue-green) matched to workload types like stateful, GPU, or batch. - Runbooks & Checklists: Produces copyable gcloud/kubectl command sequences and pre/post-upgrade checklists, including PDB backup-and-restore procedures and maintenance exclusion configuration. - Troubleshooting: Diagnoses stuck upgrades across PDB blocks, resource constraints, bare pods, admission webhooks, PVC issues, stockouts, and GPU driver regressions. - Use Case: A platform engineer needs to move production clusters from GKE 1.29 to 1.30 across dev, staging, and prod. The Skill outputs a rollout sequencing plan, per-pool surge settings, exclusion windows for a freeze period, and a rollback runbook. ## Quick Start Ask the assistant to plan a GKE upgrade for your cluster, providing the cluster mode, current and target versions, release channel, and workload types.

Frequently Asked Questions about gke-upgrades

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

FAQPage Schema
How do I plan a GKE cluster upgrade?▼

Provide your cluster mode (Standard or Autopilot), current and target versions, release channel, and workload types. The Skill produces a plan covering version compatibility, sequential upgrade paths, node pool strategy, workload readiness, and rollback procedures.

Surge vs blue-green node pool upgrades in GKE?▼

Surge upgrades are the default, using maxSurge and maxUnavailable settings per pool. Blue-green suits mission-critical workloads needing fast rollback, while autoscaled blue-green (Preview) avoids pre-provisioning double capacity.

Why is my GKE upgrade stuck or not progressing?▼

Common causes are PDBs with zero allowed disruptions, insufficient capacity for pending pods, bare pods blocking drains, admission webhooks rejecting pods, and PVC attachment failures. It may also be paused by a closed maintenance window, which is a safe mixed-version state.

Can GKE maintenance exclusions block upgrades longer than 90 days?▼

No-upgrades exclusions are capped at 90 days each, with at most 3 per cluster and 48 hours of maintenance availability required per rolling 92-day window. For longer freezes, use no_minor_or_node_upgrades scope, which runs until the minor version's End of Support.

How do I upgrade GKE GPU node pools without breaking CUDA?▼

Use rolling upgrades with maxSurge=0 since GPU reservations lack spare capacity, and test driver and CUDA compatibility in staging first. If regressions occur, pin the previous driver version or roll back the node pool to the prior GKE version.

Can I roll back a GKE control plane upgrade?▼

Control plane patch downgrades are supported directly, and minor rollback is only possible during step one of the 2-step minor upgrade. Other control plane minor rollbacks require GKE Support, while node pools can be downgraded directly or via a replacement pool.