La misma imagen debe ejecutarse en todos los entornos, así que la configuración vive fuera de ella. Un ConfigMap guarda configuración no secreta como pares clave-valor. Se crea a partir de literales (--from-literal=clave=valor), de archivos (--from-file=CLAVE=RUTA, donde el archivo entero se convierte en un valor) o de un manifiesto.
Los contenedores leen un ConfigMap de tres formas: una clave como variable de entorno (valueFrom.configMapKeyRef), todas las claves como variables (envFrom) o todas las claves como archivos en un directorio montado (un volumen configMap). Un Pod que hace referencia a un ConfigMap o una clave que no existen espera en CreateContainerConfigError hasta que aparezcan los datos.
El momento en que se leen confunde a mucha gente. Las variables de entorno se copian al arrancar el contenedor, así que cambiar el ConfigMap después no afecta a los Pods en marcha: reinicia el Deployment con kubectl rollout restart. Los archivos montados se actualizan en el sitio tras un breve retraso, lo que va bien a las aplicaciones que recargan su configuración.
Literales, un archivo con una clave elegida y un reinicio para recoger los cambios.