Flaky Tests: Fix, Quarantine, or Delete
The question is not how to eliminate flakiness. It is what to do with each flaky test — and there are exactly three answers, one of which people resist and should not.
Neeraj Jha
September 18, 2026
DevOps Insights
Named failure states with every cause we can document, a command that confirms or rules out each one, and how to check the fix held. Written by someone who runs this in production — including the parts that break at 3am.
Symptom
ImagePullBackOff
5 documented causes
The image name or tag is wrong
kubectl describe pod <pod> | grep -A5 EventsMissing or wrong registry credentials
kubectl get pod <pod> -o jsonpath='{.spec.imagePullSecrets}'The registry is implied rather than stated
kubectl get pod <pod> -o jsonpath='{.spec.containers[*].image}'The node cannot reach the registry
kubectl describe pod <pod> | grep -i -E 'timeout|no such host|connection refused|i/o timeout'New to this
An ordered path through the fundamentals, so you are not picking articles at random.
Something is broken
Named errors with every cause, a command that confirms each one, and how to verify the fix.
Not broken yet
Paste a manifest or Dockerfile. Findings link to the failure each one causes, before it causes it.
Want to understand
Ordered paths, the long guides, and four kinds of explanation — each labelled with the question it answers.
Want depth
Everything on one subject in one place: articles, questions and guides together.
Not a list of articles about Kubernetes. A path from the error you are looking at to a cause you have confirmed — because nothing here can see your cluster, so nothing here asks you to take its word for it.
The question is not how to eliminate flakiness. It is what to do with each flaky test — and there are exactly three answers, one of which people resist and should not.
Neeraj Jha
September 18, 2026
Most teams generate an SBOM and never read one. The single question it answers well, the four things it does not, and the difference between a compliance artifact and an operational one.
Neeraj Jha
September 18, 2026
Autonomy is not one decision. The four levels, the three properties that make an action safe to automate, and why the guardrail cannot live in the prompt.
Neeraj Jha
September 18, 2026
Four hundred lines, deployed to production, written by somebody who left. How to get oriented fast, in an order that works — and why the file may not be what is running.
Neeraj Jha
September 18, 2026
Small on purpose. Every failure state here lists every cause we could document and source, which is only possible for problems that have a finite cause set — so the catalogue grows when there is something complete to add, not to fill a page.