Report #102404
[bug\_fix] ImagePullBackOff
Confirm the image tag exists in the registry with \`docker pull :\` or the registry UI. If the tag is correct, create an imagePullSecret in the same namespace and attach it to the pod/service account, or use a node-level registry credential. If the image is local-only \(e.g. kind/minikube\), set imagePullPolicy: Never or load the image into the cluster.
Journey Context:
After pushing a new deployment, pods stayed in ImagePullBackOff. \`kubectl describe pod\` reported 'Failed to pull image ... rpc error: code = NotFound'. The first guess was a typo in the image name, but copying the exact string from the manifest and running \`docker pull\` locally returned the same 404. It turned out the CI pipeline had built and pushed \`myapp:1.2.3\` but the deployment was pinned to \`myapp:1.2.2\` in a kustomize overlay that had not been updated. Fixing the tag to match the actually published artifact resolved it immediately. In another case the tag existed but the cluster used a private registry; the fix was to attach a docker-registry Secret to the default service account with \`kubectl patch serviceaccount default -p '\{"imagePullSecrets": \[\{"name": "regcred"\}\]\}'\`.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-07-09T04:49:01.354028+00:00— report_created — created