GUIDE TECHNIQUE · KUBERNETES
Gérer ConfigMap et Secret Kubernetes
Créer une ConfigMap non sensible et un Secret fictif, les consommer effectivement dans un Pod puis vérifier les valeurs sans les afficher en clair dans les logs. Ajouter les limites de sécurité des Secrets Kubernetes.
L’ESSENTIEL EN BREF
Comment procéder ?
Créer une ConfigMap non sensible et un Secret fictif, les consommer effectivement dans un Pod puis vérifier les valeurs sans les afficher en clair dans les logs. Ajouter les limites de sécurité des Secrets Kubernetes.
Résultat à atteindre : ConfigMap créée avec données non sensibles.
Avant de commencer : Cluster de test autorisé et contexte kubectl vérifié.
01 · CADRAGE
Ce que vous allez mettre en place
Créer une ConfigMap non sensible et un Secret fictif, les consommer effectivement dans un Pod puis vérifier les valeurs sans les afficher en clair dans les logs. Ajouter les limites de sécurité des Secrets Kubernetes.
Pour qui : Administrateurs Kubernetes, équipes DevOps et SRE
Kubernetes stable avec kubectl compatible ; les images de laboratoire sont illustratives et doivent être validées avant usage réel.
Vérifiez la compatibilité avec votre environnement réel. Les versions ne sont jamais présumées identiques d’un tenant à l’autre.
02 · AVANT DE COMMENCER
Prérequis et points de contrôle
- Cluster de test autorisé et contexte kubectl vérifié.
- Droits de créer/supprimer un namespace de recette ; aucun workload client dans ce namespace.
- Capacité à lire Pods, événements et logs après déploiement.
03 · VUE D’ENSEMBLE
Comprendre l’architecture et les flux
04 · TUTORIEL
Procédure complète, étape par étape
Chaque étape explique l’action, sa raison, le contrôle attendu et les erreurs habituelles. Adaptez les exemples aux paramètres de votre propre environnement.
ÉTAPE 1 / 5
Créer un namespace dédié
La ConfigMap transporte des paramètres ordinaires ; Secret transporte des octets destinés à un traitement plus restreint mais n'est pas automatiquement chiffré de bout en bout.
- Choisir un cluster de recette avec RBAC limité.
- Créer un namespace dédié.
- Vérifier le contexte avant toute ressource.
kubectl config current-context
kubectl create namespace adn-config-labÀ vérifier : Namespace créé dans le bon cluster.
Point de vigilance ADN : Limiter RBAC get/list/watch sur Secrets et activer le chiffrement au repos selon le cluster.
ÉTAPE 2 / 5
Créer une ConfigMap de test
Un paramètre public peut être fourni à un Pod par une ConfigMap.
- Créer adn-config avec mode=demo.
- Lire ses métadonnées sans données sensibles.
- Prévoir une référence explicite dans le manifeste de Pod.
kubectl -n adn-config-lab create configmap adn-config --from-literal=mode=demo
kubectl -n adn-config-lab get configmap adn-configÀ vérifier : adn-config existe avec une clé mode.
Point de vigilance ADN : Les ConfigMaps ne doivent contenir ni jetons ni mots de passe.
ÉTAPE 3 / 5
Créer un Secret fictif
Pour un vrai secret, éviter --from-literal sur la ligne de commande car les arguments peuvent être historisés ou visibles par d'autres processus.
- Dans le laboratoire, créer un fichier contenant une valeur fictive non sensible.
- Créer le Secret à partir du fichier de recette.
- Effacer le fichier de test après usage ; en production, utiliser un fournisseur sécurisé, des fichiers temporaires protégés ou une intégration de coffre.
umask 077
printf 'EXEMPLE-VALEUR-FICTIVE' > demo-token.txt
kubectl -n adn-config-lab create secret generic adn-secret --from-file=api-key=demo-token.txt
rm demo-token.txt
kubectl -n adn-config-lab get secret adn-secretÀ vérifier : Un Secret opaque nommé adn-secret existe.
Point de vigilance ADN : Ne pas exécuter kubectl get secret -o yaml ni afficher ses valeurs dans les comptes-rendus.
ÉTAPE 4 / 5
Vérifier les ressources sans révéler les valeurs
La création des ressources ne démontre rien tant qu'un Pod ne les consomme pas.
- Créer pod.yaml avec un Pod de recette lisant mode via ConfigMap et api-key via un volume Secret.
- Limiter l'affichage au nom des fichiers du volume et à la variable non sensible.
- Ne pas utiliser cat sur le chemin du Secret pendant la recette.
apiVersion: v1
kind: Pod
metadata:
name: demo-config
namespace: adn-config-lab
spec:
restartPolicy: Never
containers:
- name: demo
image: busybox:1.36
command: ["sh", "-c", "echo mode=$MODE; ls -l /etc/creds; sleep 300"]
env:
- name: MODE
valueFrom:
configMapKeyRef: {name: adn-config, key: mode}
volumeMounts:
- {name: creds, mountPath: /etc/creds, readOnly: true}
volumes:
- name: creds
secret: {secretName: adn-secret}
# Enregistrer dans pod.yaml ; puis : kubectl apply -f pod.yamlÀ vérifier : Le Pod reçoit la variable non sensible MODE et le volume Secret monté sous /etc/creds.
Point de vigilance ADN : Le Pod est éphémère et ne doit pas être associé à un accès Internet externe.
ÉTAPE 5 / 5
Supprimer les ressources de recette
Valider la consommation sans afficher la valeur secrète est un prérequis sécurité.
- Appliquer pod.yaml et attendre Running.
- Vérifier que la ConfigMap apparaît sous mode=demo et que le fichier api-key existe.
- Supprimer seulement le namespace de test après vérification.
kubectl apply -f pod.yaml
kubectl -n adn-config-lab wait --for=jsonpath='{.status.phase}'=Running pod/demo-config --timeout=90s
kubectl -n adn-config-lab logs pod/demo-config
# Attendu : mode=demo et fichier api-key listé, jamais sa valeur.
kubectl delete namespace adn-config-labÀ vérifier : Le Pod lit le mode et monte le fichier api-key sans afficher EXEMPLE-VALEUR-FICTIVE.
Point de vigilance ADN : La base etcd, le RBAC et les sauvegardes doivent être protégés ; un Secret ne remplace pas un gestionnaire de secrets.
SOURCES ET FIABILITÉ
Statut de validation du guide
Rédaction : ADN Consulting. Statut : procédure documentée, exécution en laboratoire non attestée.
Les exemples et versions indiqués doivent être vérifiés sur un environnement autorisé. Aucune validation individuelle par un consultant n’est revendiquée sans preuve.
05 · RECETTE
Comment vérifier que tout fonctionne ?
ConfigMap créée avec données non sensibles.
Secret créé depuis un fichier de recette, pas un véritable secret en argument CLI.
Pod consomme effectivement les deux objets.
Les sorties n'exposent pas la valeur du Secret.
Namespace de recette purgé et préconisations RBAC/chiffrement indiquées.
06 · DIAGNOSTIC
Problèmes fréquents et résolution
ImagePullBackOff
Cause probable : Image absente, accès registre ou tag incorrect
Que faire : Lire kubectl describe pod et les événements avant changement d'image.
CrashLoopBackOff
Cause probable : Conteneur instable ou configuration invalide
Que faire : Lire les logs --previous et livenessProbe ; corriger à la source.
Rollout bloqué
Cause probable : Pods non prêts ou capacité du cluster insuffisante
Que faire : Examiner rollout status, describe et quota du namespace.
Le conseil de l’expert ADN
Avant de généraliser cette configuration, validez-la sur un périmètre représentatif, documentez les critères de réussite et conservez une procédure de retour arrière. Une automatisation fiable se juge sur l’état final observé, les permissions maîtrisées et un retour arrière testé.
07 · QUESTIONS PRATIQUES
Questions fréquentes
Puis-je reprendre ces commandes en production ?
Non sans adaptation, revue de sécurité, approbation de changement et tests sur un environnement identique.
Pourquoi ne suffit-il pas d'appliquer le manifeste ?
Le contrôleur peut accepter l'objet alors que les Pods ne sont pas prêts ou que le service ne répond pas.
AUTRES TECHNOLOGIES
Guides complémentaires
Ce tutoriel s’inscrit dans une chaîne technique plus large. Retrouvez les méthodes associées aux technologies voisines.
