Accueil › Docker & conteneurs › La configuration par l'environnement, et ses limites
La configuration par l'environnement, et ses limites
Configuration et secretsintermediaire
Une image doit être la même en recette et en production. Ce qui change d'un environnement à l'autre n'est pas le contenu de l'image, c'est ce qu'on lui passe au lancement. Reconstruire une image parce que l'adresse de la base de données change, c'est renoncer à savoir ce qu'on a testé.
Trois sources, un ordre
ENV NIVEAU_LOG=info
ENV PORT=3000
L'image fournit les valeurs par défaut : un conteneur lancé sans aucune option doit démarrer. La description du service les remplace :
services:
api:
image: mon-api:1.4.2
environment:
NIVEAU_LOG: warn
Et le lancement remplace tout le reste. La règle tient en une phrase : plus la source est proche du lancement, plus elle gagne.
Ce qu'une variable n'est pas
Elle n'est pas un coffre. L'environnement d'un conteneur se lit par l'inspection de ce conteneur, il est souvent recopié dans les journaux d'une plateforme d'orchestration, et il est hérité par tout processus fils. Une valeur de configuration — un port, un niveau de journalisation, une adresse — y a sa place. Un mot de passe n'y a pas la sienne.
Elle n'est pas non plus dynamique : l'environnement est transmis une fois, au démarrage du processus. Changer la valeur dans la description du service n'affecte rien tant que le conteneur n'est pas recréé.
Les termes à connaître
- Configuration externalisée
Le principe selon lequel une même image tourne en recette et en production, et ne diffère que par les valeurs qu'on lui passe au lancement.
- Variable d'environnement
Une paire nom-valeur transmise au processus au démarrage. Elle est lue au lancement et ne change plus pendant la vie du conteneur.
- ENV
L'instruction qui écrit une variable dans les métadonnées de l'image. Elle vaut pour toutes les instructions suivantes et pour tout conteneur issu de l'image.
- Fichier d'environnement
Un fichier de paires nom-valeur chargé au lancement. Il reste sur la machine hôte et n'entre pas dans l'image.
- Précédence
L'ordre qui décide quelle source l'emporte quand plusieurs définissent la même variable. La source la plus proche du lancement gagne.
- Valeur par défaut
La valeur inscrite dans l'image pour qu'un conteneur démarre sans configuration. Elle doit toujours correspondre au cas le moins privilégié.
- Fuite par inspection
Le fait qu'une variable d'environnement d'un conteneur soit lisible par l'inspection du conteneur, par les journaux de la plateforme et par tout processus du même espace.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.