sre-k8s-rollback-investigator

Diagnose Kubernetes Deployment rollout failures using rollout history and ReplicaSet state.

Updated Apr 5, 2026
One-click install
npx skills add https://github.com/schoolofdevops/401 --skill sre-k8s-rollback-investigator-schoolofdevops
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sre-k8s-rollback-investigator
Source: https://github.com/schoolofdevops/401/tree/main/skills/sre-k8s-rollback-investigator
Command: npx skills add https://github.com/schoolofdevops/401 --skill sre-k8s-rollback-investigator-schoolofdevops

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a Kubernetes Deployment rollout fails or production behavior changes after a recent deploy, on-call engineers need a structured, read-only way to gather rollout evidence before deciding on a rollback. This Skill collects Deployment status, rollout history, and ReplicaSet state so the rollback decision is based on facts rather than guesswork. ## Core Features & Use Cases - Rollout Evidence Collection: Runs four deterministic kubectl commands to capture Deployment JSON, rollout history, rollout status, and ReplicaSet lists. - Decision Branches: Provides structured reasoning branches for ProgressDeadlineExceeded, image regressions, replica availability gaps, and ReplicaSet sprawl. - Read-Only Safety: Never executes rollbacks, scaling, or deletions; it only gathers evidence and escalates with a complete handoff package. - Use Case: A Deployment shows Progressing == False after a new image push. Use this Skill to compare the current and previous ReplicaSet images, confirm the regression timing, and escalate with a recommended rollback revision. ## Quick Start Ask the agent to investigate why the deployment named in $DEPLOYMENT_NAME failed to roll out in the given namespace and whether a rollback is warranted.

Frequently Asked Questions about sre-k8s-rollback-investigator

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

FAQPage Schema
How do I investigate a failed Kubernetes deployment rollout?

Run kubectl get deployment for status conditions, kubectl rollout history for revision sequence, kubectl rollout status for current state, and kubectl get replicaset filtered by app label. Compare the current and previous ReplicaSet images and check for ProgressDeadlineExceeded in the conditions.

How to detect an image regression after a Kubernetes deploy?

List ReplicaSets for the deployment and compare spec.template.spec.containers[].image between the newest ReplicaSet (highest revision) and the previous one. If the image tag changed and incident timing matches the rollout timestamp, the new image is the likely regression source.

What does ProgressDeadlineExceeded mean in a Kubernetes deployment?

ProgressDeadlineExceeded means the new ReplicaSet pods failed to become Ready within the deployment's progressDeadlineSeconds window. The rollout is stuck, and you should diagnose the newest ReplicaSet's pods and consider rolling back to the previous revision.

Can this skill perform a kubectl rollback automatically?

No, the skill is strictly read-only and never executes kubectl rollout undo, scale, delete, or set image. It gathers evidence and escalates with a recommended rollback target revision, but a human must approve and execute any rollback.

When should I not use rollout investigation for Kubernetes issues?

Do not use it for pod-level crash diagnosis, resource quota exhaustion, or cluster node failures, which require dedicated pod health, quota, or node health skills. It focuses only on Deployment rollout history and ReplicaSet state.