Variables d’environnement
100%

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.

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.

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
Leçon Suivante
Retour à Docker Compose