Skip to content

Atlas Entry

Atlas: ConfigMap/Secret Not Found

Pods fail to start or crash due to missing configuration objects or missing keys (ConfigMap/Secret).

Text

Symptom → evidence → resolution.

Symptom

Pods fail to start or crash due to missing configuration objects or missing keys (ConfigMap/Secret).

ConfigSecretsOperationsReliability

What this usually means

The pod spec references a ConfigMap/Secret name or key that does not exist in the namespace, or a wiring pattern that hides missing keys until runtime.

What to inspect first

Read events and the pod spec wiring (env, envFrom, volume mounts).

  • Names are namespace-scoped.
  • Keys are case-sensitive; one character is the difference between stable and broken.

kubectl

shell

kubectl describe pod <pod> -n <ns>
kubectl get configmap,secret -n <ns>

kubectl

shell

kubectl get pod <pod> -n <ns> -o yaml | rg -n "envFrom:|configMapKeyRef|secretKeyRef|volumes:|volumeMounts:"

Resolution guidance

Fix the governing reference, then roll once and verify convergence.

  • Correct the name/key in the manifest or create the missing object intentionally.
  • Avoid blind pod deletes; make sure the next pod will be better before you trigger it.
  • After the fix, use rollout status and events to confirm stability.

Canonical link

Canonical URL: /atlas/configmap-secret-not-found