Kubernetes Deprecated & Removed API Migration Prompt
Find and remediate deprecated/removed API usages (in live objects, Helm charts, and CI) before a version bump breaks them, using kubent, Pluto, and the API deprecation guide.
- Target user
- Platform engineers planning Kubernetes version upgrades
- Difficulty
- Intermediate
- Tools
- Claude, ChatGPT
The prompt
You are an upgrade specialist who has caught removed-API landmines before they detonated mid-upgrade. You know that the cluster upgrading is not the same as your manifests being safe. I will provide: - Current and target Kubernetes versions - Where manifests live (Git, Helm charts, raw kubectl, Argo/Flux) - Whether admission webhooks or operators install their own CRDs/objects - CI/CD setup Your job: 1. **Two surfaces of risk** — distinguish (a) *live objects* in the cluster still using soon-removed group/versions and (b) *source manifests/charts/templates* in Git that would re-apply a removed apiVersion after upgrade. Both must be fixed; fixing only the cluster lets GitOps reintroduce the old version. 2. **Detect** — run `kubent` (kube-no-trouble) against the live cluster and `pluto detect-files` / `pluto detect-helm` against repos and rendered charts. Explain reading their output (deprecated vs removed-in, replacement apiVersion). 3. **Map removals to versions** — for the target version, list the concrete removals to expect (consult the official deprecated-API migration guide for that release) and the replacement apiVersions, not just "something changed." 4. **Remediate** — update apiVersions in source, bump Helm chart `kubeVersion`/templates, and for stored objects use `kubectl-convert` or re-apply the new version so etcd no longer serves the old one (storage version migration where needed). 5. **Webhooks & CRDs** — check that admission webhooks' `admissionReviewVersions` and CRD `served`/`storage` versions are compatible; a removed CRD served-version can break the operator. 6. **CI gate** — add a pre-merge job (Pluto on rendered manifests) that fails any PR introducing an apiVersion removed in your target version, so the fix doesn't regress. 7. **Order of operations** — fix source → re-apply/convert live objects → verify clean kubent → then upgrade. Give a rollback note. Output as: (a) the detection command set for cluster + repos + charts, (b) a remediation table (old apiVersion → new), (c) a Pluto CI gate config, (d) the storage-version-migration steps, (e) the top 3 ways a "clean upgrade" still breaks workloads afterward. Bias toward: fixing source before cluster, gating CI, and verifying with a clean re-scan before the upgrade.
Run this prompt with AI
Test it, get an AI-improved version, or compare models — live in the Prompt Workspace. No copy-paste.
Related prompts
-
Helm Chart Major-Version Values Migration Prompt
Plan a breaking Helm chart major-version upgrade — diff the values schema, map renamed and removed keys, handle CRD upgrades, and stage the upgrade so the new template renders against your existing config safely.
-
Kubernetes Cluster Upgrade Pre-Flight Planning Prompt
Pre-upgrade safety review of a Kubernetes cluster going N → N+1 (or N+2 skip) — deprecated APIs, removed features, control-plane & node ordering, workload compatibility.
-
Helm Secrets + SOPS Encrypted Values Workflow Prompt
Design a GitOps-safe workflow for encrypting Helm values with the helm-secrets plugin and SOPS (age/KMS) — encrypted values in git, decryption at deploy time, key rotation, and CI wiring.
-
Kubernetes Encryption-at-Rest KMS Provider Design Prompt
Design and roll out etcd encryption-at-rest with an EncryptionConfiguration and a KMS v2 provider — provider ordering, key rotation, and re-encrypting existing Secrets without downtime.
More Kubernetes & Helm prompts & error guides
Browse every Kubernetes & Helm prompt and troubleshooting guide in one place.
Reading prompts? Get all 500 in one free PDF
500 battle-tested, copy-paste AI prompts engineered by a senior systems engineer — every one with fill-in placeholders and safety/back-out notes. Drop your email and it's yours.
- 500 prompts: Linux · Kubernetes · Terraform · OpenStack · GitLab · Docker · Monitoring · Incident Response
- Instant PDF download — yours free, forever
- Plus one practical AI-workflow email a week (no spam)
Single opt-in · unsubscribe anytime · no spam.