Une variable d’environnement est une valeur nommée qu’un programme peut lire. Compose peut s’en servir de deux façons : pour insérer une valeur à la lecture du fichier et pour transmettre une valeur à un programme dans un conteneur.
Docker Compose · Leçon 5
Variables d’environnement
Apprenez à distinguer une valeur insérée dans un fichier Compose d’une valeur transmise à un conteneur.
Insérer une valeur dans le fichier
Enregistrez cet exemple sous le nom compose.env.yaml dans le dossier d’exercice. L’expression ${PAGE_MODE:-demo} indique d’utiliser la valeur de PAGE_MODE si la variable est définie et non vide. Sinon, Compose utilise demo.
services:
toolbox:
image: busybox:1.36
environment:
PAGE_MODE: "${PAGE_MODE:-demo}"
Compose résout l’expression avant de créer le conteneur. C’est ce qu’on appelle l’interpolation. Vous pourrez rencontrer la même technique dans d’autres fichiers pour choisir un port de l’hôte ou une étiquette d’image.
Si PAGE_MODE n’est pas définie, quelle valeur apparaît dans la configuration affichée ?
Afficher la valeur retenue
Une affectation placée avant une commande définit la variable pour cette seule exécution. Utilisez cette syntaxe pour voir l’effet d’une autre valeur. La commande config affiche les réglages après interpolation sans créer de conteneur.
$ PAGE_MODE=review docker compose -p journey-env -f compose.env.yaml config
Repérez PAGE_MODE: review dans l’environnement du service. La valeur review sert à l’exercice. Évitez d’inclure des secrets dans les exemples de configuration ou dans les sorties affichées.
La configuration affichée contient review. Que s’est-il passé jusqu’ici ?
Transmettre une valeur au conteneur
La section environment transmet la valeur retenue à un nouveau conteneur. Utilisez printenv pour afficher cette valeur depuis le conteneur créé pour l’occasion.
$ PAGE_MODE=review docker compose -p journey-env -f compose.env.yaml run --rm toolbox printenv PAGE_MODE
Vous devriez obtenir review. L’interpolation a déterminé la valeur et l’entrée d’environnement l’a transmise au conteneur. Une variable qui sert uniquement à choisir un port de l’hôte ne devient pas automatiquement une variable d’environnement du programme.
Que faire pour vérifier la valeur reçue par le programme dans le conteneur d’outils ?
Leçon terminée
Vous avez terminé Variables d’environnement
Vous savez maintenant distinguer les deux usages des variables d’environnement.
Lisez une expression avec une valeur par défaut dans un fichier Compose.
Vérifiez la configuration après interpolation, avant de démarrer un conteneur.
Vérifiez une valeur dans l’environnement du programme en cours d’exécution.
Conservez votre progression
Créez un compte gratuit pour enregistrer cette leçon et continuer sur n'importe quel appareil.
Créer un compte gratuit