8. ConfigMap
Fiche construite à partir du blog de Stéphane Robert : ConfigMaps.
Pourquoi un ConfigMap ?
Section titled “Pourquoi un ConfigMap ?”Ressource Kubernetes qui stocke des paires clé/valeur non sensibles, pour :
- Externaliser la configuration du code
- Réutiliser la même image dans différents environnements
- Modifier la configuration sans redéployer l’application
Créer un ConfigMap
Section titled “Créer un ConfigMap”- Des valeurs littérales ou un fichier .env donnent une clé par valeur (variables d’environnement)
- Un fichier entier donne une seule clé portant tout le contenu (fichier de configuration). Le nom du fichier devient la clé.
Depuis un fichier de configuration complet
Section titled “Depuis un fichier de configuration complet”cat > nginx.conf << 'EOF'server { listen 80; server_name localhost; location / { root /usr/share/nginx/html; }}EOF
kubectl create configmap nginx-config --from-file=nginx.conf
kubectl get configmap nginx-config -o yamlapiVersion: v1kind: ConfigMapdata: nginx.conf: | server { listen 80; server_name localhost; ...Depuis un fichier .env
Section titled “Depuis un fichier .env”vim app.envAPP_ENV=productionLOG_LEVEL=infoMAX_CONNECTIONS=100kubectl create configmap nginx-config --from-env-file=app.envDepuis un fichier YAML
Section titled “Depuis un fichier YAML”vim app-config.ymlapiVersion: v1kind: ConfigMapmetadata: name: app-settingsdata: APP_ENV: production LOG_LEVEL: info MAX_CONNECTIONS: "100"kubectl apply -f app-config.ymlInspecter un ConfigMap
Section titled “Inspecter un ConfigMap”kubectl get configmap # Liste les ConfigMapkubectl describe configmap app-settings # Affiche chaque clé suivie de sa valeurkubectl get configmap app-settings -o yaml # Affiche le format yaml : utile pour récupérer un ConfigMap existant et le versionnerInjecter un ConfigMap dans un Pod
Section titled “Injecter un ConfigMap dans un Pod”| Méthode | Cas d’usage | Mise à jour auto |
|---|---|---|
1. env + valueFrom |
Variables spécifiques | Non |
2. envFrom |
Toutes les variables d’un coup | Non |
| 3. Volume | Fichiers de configuration | Oui, après propagation |
Méthode 1 : env + valueFrom
Section titled “Méthode 1 : env + valueFrom”apiVersion: apps/v1kind: Deploymentmetadata: name: myappspec: replicas: 1 selector: matchLabels: app: myapp template: metadata: labels: app: myapp spec: containers: - name: app image: nginx:1.29-alpine@sha256:5616878291a2eed594aee8db4dade5878cf7edcb475e59193904b198d9b830de env: - name: APP_ENV valueFrom: configMapKeyRef: name: app-settings key: APP_ENV - name: LOG_LEVEL valueFrom: configMapKeyRef: name: app-settings key: LOG_LEVELMéthode 2 : envFrom
Section titled “Méthode 2 : envFrom”apiVersion: apps/v1kind: Deploymentmetadata: name: myappspec: selector: matchLabels: app: myapp template: metadata: labels: app: myapp spec: containers: - name: app image: nginx:1.29-alpine@sha256:5616878291a2eed594aee8db4dade5878cf7edcb475e59193904b198d9b830de envFrom: - configMapRef: name: app-settings# Pour vérifierkubectl exec deploy/myapp -- env | grep -E 'APP_|LOG_|MAX_'APP_ENV=productionLOG_LEVEL=infoMAX_CONNECTIONS=100Méthode 3 : Volume
Section titled “Méthode 3 : Volume”apiVersion: apps/v1kind: Deploymentmetadata: name: nginxspec: selector: matchLabels: app: nginx template: metadata: labels: app: nginx spec: containers: - name: nginx image: nginx:1.29-alpine@sha256:5616878291a2eed594aee8db4dade5878cf7edcb475e59193904b198d9b830de volumeMounts: - name: config mountPath: /etc/nginx/conf.d volumes: - name: config configMap: name: nginx-configPièges
Section titled “Pièges”1. Variables d’environnement jamais rafraîchies
Section titled “1. Variables d’environnement jamais rafraîchies”# Modifier le ConfigMapkubectl patch configmap app-settings --type merge -p '{"data":{"APP_ENV":"staging"}}'
# La variable dans le Pod garde l'ancienne valeurkubectl exec deploy/myapp -- printenv APP_ENV# Affiche : production (pas staging !)2. subPath ne se met jamais à jour
Section titled “2. subPath ne se met jamais à jour”volumeMounts:- name: config mountPath: /etc/nginx/nginx.conf subPath: nginx.conf # ATTENTION : pas de refresh auto3. La propagation peut prendre deux minutes, pas une
Section titled “3. La propagation peut prendre deux minutes, pas une”Le kubelet vérifie la fraîcheur du ConfigMap à chaque synchronisation périodique, mais il lit la valeur courante dans un cache local à durée de vie limitée. Les deux délais s’additionnent : la documentation Kubernetes annonce jusqu’à la période de synchronisation du kubelet (1 minute par défaut) plus la durée de vie du cache (1 minute par défaut), soit deux minutes.
# Modifier le ConfigMapkubectl patch configmap nginx-config --type merge \ -p '{"data":{"nginx.conf":"server { listen 8080; }"}}'
# Vérifier, en boucle plutôt qu'en pariant sur un sleepkubectl exec deploy/nginx -- cat /etc/nginx/conf.d/nginx.confForcer le rafraîchissement sans attendre
Section titled “Forcer le rafraîchissement sans attendre”kubectl annotate pod mon-pod relance="$(date +%s)" --overwriteEn production : ConfigMaps immutables
Section titled “En production : ConfigMaps immutables”Marquer ses ConfigMaps comme immutables pour :
- Empêcher les modifications accidentelles
- Améliorer les performances (Kubernetes ne surveille plus les changements)
apiVersion: v1kind: ConfigMapmetadata: name: app-settings-v1data: APP_ENV: productionimmutable: trueWorkflow avec ConfigMaps immutables
Section titled “Workflow avec ConfigMaps immutables”- Créer un nouveau ConfigMap portant un nom versionné,
app-settings-v2par exemple - Mettre à jour le Deployment pour qu’il pointe vers ce nouveau ConfigMap
- Supprimer l’ancien une fois qu’aucun Pod ne le référence plus