Skip to content

8. ConfigMap

Fiche construite à partir du blog de Stéphane Robert : ConfigMaps.

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
  1. Des valeurs littérales ou un fichier .env donnent une clé par valeur (variables d’environnement)
  2. 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”
Terminal window
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 yaml
apiVersion: v1
kind: ConfigMap
data:
nginx.conf: |
server {
listen 80;
server_name localhost;
...
Terminal window
vim app.env
APP_ENV=production
LOG_LEVEL=info
MAX_CONNECTIONS=100
Terminal window
kubectl create configmap nginx-config --from-env-file=app.env
Terminal window
vim app-config.yml
apiVersion: v1
kind: ConfigMap
metadata:
name: app-settings
data:
APP_ENV: production
LOG_LEVEL: info
MAX_CONNECTIONS: "100"
Terminal window
kubectl apply -f app-config.yml
Terminal window
kubectl get configmap # Liste les ConfigMap
kubectl describe configmap app-settings # Affiche chaque clé suivie de sa valeur
kubectl get configmap app-settings -o yaml # Affiche le format yaml : utile pour récupérer un ConfigMap existant et le versionner
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
apiVersion: apps/v1
kind: Deployment
metadata:
name: myapp
spec:
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_LEVEL
apiVersion: apps/v1
kind: Deployment
metadata:
name: myapp
spec:
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
Terminal window
# Pour vérifier
kubectl exec deploy/myapp -- env | grep -E 'APP_|LOG_|MAX_'
APP_ENV=production
LOG_LEVEL=info
MAX_CONNECTIONS=100
apiVersion: apps/v1
kind: Deployment
metadata:
name: nginx
spec:
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-config

1. Variables d’environnement jamais rafraîchies

Section titled “1. Variables d’environnement jamais rafraîchies”
Terminal window
# Modifier le ConfigMap
kubectl patch configmap app-settings --type merge -p '{"data":{"APP_ENV":"staging"}}'
# La variable dans le Pod garde l'ancienne valeur
kubectl exec deploy/myapp -- printenv APP_ENV
# Affiche : production (pas staging !)
volumeMounts:
- name: config
mountPath: /etc/nginx/nginx.conf
subPath: nginx.conf # ATTENTION : pas de refresh auto

3. 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.

Terminal window
# Modifier le ConfigMap
kubectl patch configmap nginx-config --type merge \
-p '{"data":{"nginx.conf":"server { listen 8080; }"}}'
# Vérifier, en boucle plutôt qu'en pariant sur un sleep
kubectl exec deploy/nginx -- cat /etc/nginx/conf.d/nginx.conf
Terminal window
kubectl annotate pod mon-pod relance="$(date +%s)" --overwrite

Marquer ses ConfigMaps comme immutables pour :

  • Empêcher les modifications accidentelles
  • Améliorer les performances (Kubernetes ne surveille plus les changements)
apiVersion: v1
kind: ConfigMap
metadata:
name: app-settings-v1
data:
APP_ENV: production
immutable: true
  1. Créer un nouveau ConfigMap portant un nom versionné, app-settings-v2 par exemple
  2. Mettre à jour le Deployment pour qu’il pointe vers ce nouveau ConfigMap
  3. Supprimer l’ancien une fois qu’aucun Pod ne le référence plus