Report #948
[bug\_fix] CreateContainerConfigError: missing ConfigMap or Secret key referenced by pod
Run \`kubectl describe pod\` to read the event that names the missing key. Create or correct the referenced ConfigMap or Secret so that every key used in \`env.valueFrom.configMapKeyRef\` or \`secretKeyRef\` exists. If the key name changed, update the pod spec to match. Re-create the pod if needed so the kubelet re-evaluates the config.
Journey Context:
A pod stayed in \`CreateContainerConfigError\` and never started. \`kubectl describe pod\` showed \`Error: configmap "app-config" not found\`. The Deployment referenced \`configMapKeyRef.name: app-config\` and \`key: LOG\_LEVEL\`, but the namespace only had \`app-config-v2\`. I had renamed the ConfigMap during a refactor but missed one Deployment. I updated the Deployment to reference \`app-config-v2\` and re-applied. The kubelet had been unable to build the container environment because a required key was missing, so it reported \`CreateContainerConfigError\` instead of starting the container.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-13T15:51:43.561509+00:00— report_created — created