A systematic tool for planning Kubernetes cluster upgrades by identifying API deprecations and generating risk-aware migration runbooks.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install cluster-upgrade-planner
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install cluster-upgrade-planner using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Cluster Upgrade Planner?
The Cluster Upgrade Planner is a specialized tool within the Openclaw Skills ecosystem designed to eliminate the anxiety of Kubernetes version migrations. It performs comprehensive environment audits, detecting deprecated API usage across live clusters and local manifests while verifying the compatibility of critical addons like CNI plugins and Ingress controllers. By synthesizing cluster state facts into actionable intelligence, it ensures that DevOps engineers can upgrade their infrastructure without unexpected workload disruptions.
This skill is particularly valuable for maintaining complex production environments where manual checks are prone to error. It automates the tedious process of cross-referencing upstream compatibility matrices and identifying single-replica deployments that lack Pod Disruption Budgets. Whether you are running managed services like EKS or self-hosted kubeadm clusters, this skill provides the structure needed for a successful, rollback-safe upgrade lifecycle.
Cluster Upgrade Planner Use Cases
- Planning a minor version upgrade for production Kubernetes clusters to ensure high availability.
- Auditing local Helm charts and YAML manifests for deprecated API versions before they are deployed to a cluster.
- Generating step-by-step upgrade runbooks tailored to specific providers like EKS, GKE, or kubeadm.
- Assessing workload disruption risks by identifying pods without Pod Disruption Budgets (PDBs) before node draining.
- Verifying addon compatibility for tools like Calico, cert-manager, and CSI drivers against target Kubernetes versions.
How Cluster Upgrade Planner Works
- The skill identifies the current cluster state, including server/client versions, node statuses, and control-plane component images.
- It scans all cluster resources to find API versions that are deprecated or removed in the user-specified target Kubernetes version.
- It audits installed addons and Helm releases, fetching chart versions to verify support for the new environment.
- It evaluates workload stability by checking for high-risk configurations, such as single-replica deployments and missing disruption budgets.
- It detects the underlying infrastructure provider (EKS, GKE, AKS, or kubeadm) to select the correct upgrade strategy.
- Finally, it generates a comprehensive runbook including pre-upgrade backups, phased execution steps, and specific rollback procedures.
Cluster Upgrade Planner Setup
To utilize this within the Openclaw Skills framework, ensure you have kubectl, helm, and python3 installed and configured with access to your target cluster.
# Ensure your kubeconfig is active and pointing to the correct cluster
kubectl cluster-info
# The skill will use standard CLI tools to gather facts
# No additional server-side agents are required.
Cluster Upgrade Planner Data Schema & Taxonomy
The skill organizes its analysis into structured reports and manifests:
| Data Type | Description |
|---|---|
| Preflight Report | A summary of blockers (removed APIs), warnings (deprecated APIs), and node readiness. |
| Addon Matrix | A comparison table of current versions versus target K8s version support. |
| API Usage Dump | A localized text file (/tmp/cluster-api-usage.txt) mapping every resource to its apiVersion and Kind. |
| Upgrade Runbook | A copy-pasteable Markdown guide with phases for control-plane and worker node updates. |
| Local Manifest Audit | Findings from scanning local files, including file path, current API, and the required replacement. |
Cluster Upgrade Planner Advanced Features
- Automatic detection of cloud providers like EKS, GKE, and AKS to provide platform-specific migration commands.
- Deep scanning of local Helm templates using rendering logic to catch issues before deployment.
- Automated generation of migration commands using sed or yq to update apiVersions in local codebases.
- Intelligent timing estimation based on node count and control-plane density to assist with maintenance window planning.
- Built-in rollback procedures covering etcd restoration and package downgrades for high-stakes environments.
SKILL.md
Loading
Related Openclaw Skills
Chaos Test Designer
An AI-powered skill for designing and executing chaos engineering experiments to verify system resilience and failure recovery.
CI Pipeline Optimizer
A specialized AI skill designed to analyze and accelerate CI/CD pipelines through intelligent caching, job parallelization, and Docker layer optimization.
Biome Config Validator
A specialized utility to audit and validate biome.json configuration files for errors, conflicts, and deprecated settings.
Makefile Linter
A lightweight, dependency-free Python linter for validating Makefile syntax, portability, and best practices.
Systemd Unit Generator
A powerful tool to generate, validate, and lint hardened systemd unit files for services, timers, and sockets.
Repository Health Score
A comprehensive auditing tool that generates a 0-100 health score for any repository based on eight critical engineering dimensions.
Featured*
