Formations — 1 037 leçons en français

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.

Lire l'explication détaillée et faire le quiz →

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.