Les alternatives aux ConfigMaps

Un ConfigMap n'est pas un système de configuration. Voici ce que j'y garde vraiment, ce que j'en sors, et pourquoi l'immutabilité règle la moitié des problèmes.

Les alternatives aux ConfigMaps

Un ConfigMap de quarante lignes, cinq environnements, et personne capable de dire quelle clé est réellement lue en production. J'ai vu ce tableau trois fois cette année, sur trois stacks différentes. Le coupable n'est pas Kubernetes : c'est l'habitude de traiter le ConfigMap comme un système de configuration.

Je continue d'en créer, parfois trois par service. Mais uniquement pour ce qu'il sait faire : transporter des chaînes de caractères vers un conteneur. Le reste va ailleurs, et je vais te montrer où.

Un objet de transport, pas un format de configuration

L'API ConfigMap accepte des clés et des valeurs, sans type, sans schéma, sans validation et sans valeur par défaut. Un max_connections: "5000" et un max_connections: "50O0" avec une lettre O sont stockés avec le même enthousiasme, et l'erreur ne remonte qu'au premier pic de charge.

Le piège devient plus vicieux dès que tu montes le ConfigMap comme fichier YAML lu par ton application. En YAML 1.1, country: NO devient le booléen False sous PyYAML, et enabled: yes devient True. Ta config « texte » vient de changer de types sans prévenir, sur une clé que personne n'a touchée.

Ma parade est simple : un schéma validé au démarrage. Pydantic, JSON Schema, Zod, peu importe, du moment que le conteneur refuse de démarrer si la config ne correspond pas au schéma attendu. Un crash au déploiement coûte deux minutes, une config silencieusement fausse coûte une nuit.

Le volume monté ne se recharge pas tout seul

On lit partout que les ConfigMaps montés en volume sont « mis à jour automatiquement ». C'est vrai, à trois nuances près qui tuent l'idée. Le kubelet synchronise toutes les minutes environ, la propagation dépend de son cache de détection, et surtout ton application doit surveiller le fichier pour le relire.

La plupart des runtimes lisent leur config une fois au boot. Node avec dotenv, Python avec pydantic-settings, une JVM avec Spring : aucun ne va relire un fichier modifié sous ses pieds. Tu obtiens une config à jour sur le disque et une config périmée en mémoire, ce qui est la pire des deux situations.

Pire cas, le montage subPath, utilisé justement pour écraser un seul fichier : il ne reçoit jamais de mise à jour, par conception. J'ai perdu une demi-journée sur un nginx.conf monté en subPath dont le rechargement ne changeait rien. Le conteneur lisait en réalité une copie figée depuis son démarrage.

Depuis, j'active immutable: true sur les ConfigMaps de production, une fonctionnalité stable depuis Kubernetes 1.21. Un objet immuable ne peut plus être modifié : pour changer une valeur, tu crées un nouvel objet au nom versionné, et les pods redémarrent forcément. La documentation officielle ajoute un bénéfice mesurable, l'immutabilité allège la charge du kubelet sur les clusters chargés.

Les variables d'environnement sont figées à la naissance du pod

Un envFrom ou un valueFrom copie la valeur dans le conteneur au moment de sa création. Tu modifies le ConfigMap, rien ne bouge dans les pods en cours : la nouvelle valeur n'existera qu'après un rollout. C'est la cause numéro un des « j'ai changé la config mais ça ne marche pas ».

Le correctif coûte trois lignes dans un template Helm : une annotation calculée sur le hash du ConfigMap. Le hash entre dans le PodTemplate, donc le hash change la spec, donc Kubernetes roule les pods.

metadata:
  annotations:
    checksum/config: {{ include (print $.Template.BasePath "/configmap.yaml") . | sha256sum }}

Hors Helm, configMapGenerator de Kustomize suffixe déjà le nom avec un hash, ce que j'utilise sur les déploiements sans chart. Et si tu ne veux toucher à rien, Reloader surveille les ConfigMaps et déclenche le rollout à ta place. Trois approches, un seul principe : la config fait partie de la spec déployée, pas d'une valeur lue à l'exécution.

Ce que je garde dans un ConfigMap

Trois cas, très concrets. Le fichier de config d'un binaire tiers non modifiable : un nginx.conf, un traefik.yml, un prometheus.yml. Une poignée de scalaires statiques non sensibles : LOG_LEVEL, le nom d'un bucket, une URL de service interne. Et des drapeaux qui changent à chaque release, jamais entre deux releases.

Ce que je n'y mets plus : des secrets, même temporairement. Un ConfigMap est lisible par kubectl describe et par toute personne ayant le rôle view sur le namespace. Les credentials passent par un Secret, idéalement synchronisé depuis un coffre avec External Secrets Operator. J'ai détaillé cette mécanique dans les secrets Kubernetes avancés.

Ce que je refuse aussi : plus de cent lignes de config structurée avec des variantes par environnement. À ce stade, ce n'est plus un ConfigMap, c'est un fichier de configuration applicatif qui mérite un dépôt, un diff relu et des tests. Le ConfigMap n'est que le transport final de ce fichier.

L'objection : « deux ConfigMaps et un rollout, ça suffit »

Elle est solide, et je l'ai défendue pendant deux ans. Sur une stack de cinq services, Kustomize avec une surcouche par environnement plus une annotation de checksum, c'est suffisant. Ajouter Consul ou un serveur de config, c'est ajouter un point de panne, une dépendance réseau au démarrage et un modèle d'autorisation de plus à administrer.

Le calcul change quand trois conditions apparaissent. D'abord l'audit : qui a modifié la config de prod à 3 h du matin, et quelle était la valeur avant ? Un ConfigMap n'a ni historique ni diff, seulement un resourceVersion et un managedFields que personne ne lit. Ensuite le nombre : dix services fois quatre environnements, c'est quarante objets que personne ne compare, donc une dérive silencieuse. Enfin le rythme : une équipe qui déploie le vendredi mais qui a besoin de changer une valeur le mardi finira par le faire à la main dans le cluster.

Cette dérive ressemble beaucoup à celle des namespaces surchargés : au départ, chacun sait où il met quoi, un an plus tard plus personne. J'ai écrit sur le sujet dans les limites des namespaces trop souvent ignorées, et la conclusion vaut ici aussi.

Ma réponse n'est pas « installe un config server ». C'est de faire de la config un artefact de dépôt, versionné, relu en PR, avec un ConfigMap immuable et un nom par version en prod. Le serveur de config ne se justifie que lorsque la rotation doit être instantanée sur des centaines de pods, ou quand plusieurs clusters doivent partager un même état.

Les trois questions avant de créer l'objet

Première question : la valeur doit-elle changer sans redéploiement ? Si oui, un ConfigMap ne répond pas au besoin et il faut un vrai mécanisme de rechargement, piloté par l'application elle-même. Si non, un ConfigMap immuable et versionné fait très bien le travail.

Deuxième question : la valeur est-elle secrète, même de loin ? Si oui, c'est un Secret et un coffre, pas un ConfigMap au nom discret. Troisième question : la structure dépasse-t-elle une cinquantaine de lignes ou contient-elle des types non triviaux ? Si oui, valide-la dans le pipeline avec un schéma et monte le fichier résultant, au lieu de laisser six personnes éditer du YAML dans un cluster.

Le principe 3 du manifeste 12-factor recommande de séparer la config du code, et il reste juste. Il ne dit pas que la config doit vivre dans un objet sans schéma, sans version et sans rechargement. Cette confusion, je la vois partout, y compris chez des équipes qui soignent par ailleurs leurs images et leurs tests. Un ConfigMap reste un excellent tuyau, ne lui demande pas d'être un système.