Kubernetes · 1 steps

ImagePullBackOff

The event message names the cause almost every time — it is a question of knowing which of four failures it describes.

Every step

Read the pull error verbatim

Registry errors are specific and the wording matters. "Not found", "unauthorized", "no such host" and "timeout" have four different fixes and one shared symptom.

$ kubectl describe pod <pod> | grep -A10 Events

$ kubectl get events --sort-by=.lastTimestamp | tail -20

Look for: The Failed event message, and the exact image reference in it — including the tag, which is often the whole story.