DevOps Bootcamp · Leçon

Variables d’environnement et fichiers .env

Variables d’environnement et fichiers .env est une leçon DevOps Bootcamp gratuite sur CoddyKit. Ceci est la leçon 4 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage DevOps Bootcamp, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours DevOps Bootcamp comprend 4 leçons au total.

Pourquoi externaliser la configuration ?

Inscrire en dur les mots de passe et les ports dans un fichier Compose est fragile et peu sûr. Les variables d'environnement permettent de modifier le comportement selon l'environnement sans modifier le YAML.

Garder les secrets hors du contrôle de version
Réutiliser un même fichier Compose partout
Remplacer les valeurs au moment de l'exécution

La clé environment

Dans un service, déclarez les variables sous environment sous forme de mappage. Elles sont injectées dans le conteneur au démarrage.

services:
  db:
    image: postgres:16
    environment:
      POSTGRES_USER: app
      POSTGRES_PASSWORD: secret

Format liste

Cette même clé accepte également une liste de chaînes KEY=VALUE. Choisissez le format que vous trouvez le plus lisible.

services:
  db:
    image: postgres:16
    environment:
      - POSTGRES_USER=app
      - POSTGRES_PASSWORD=secret

Le fichier .env

Compose lit automatiquement un fichier nommé .env dans le répertoire du projet. Définissez-y les valeurs une seule fois et référencez-les avec la substitution ${VAR}.

# .env
PG_USER=app
PG_PASS=secret
WEB_PORT=8080

Substitution de variables

Utilisez ${VAR} n'importe où dans le fichier Compose. Compose le remplace par la valeur provenant de .env ou du shell avant l'analyse.

services:
  db:
    image: postgres:16
    environment:
      POSTGRES_USER: ${PG_USER}
      POSTGRES_PASSWORD: ${PG_PASS}

Valeurs par défaut

Fournissez une solution de repli avec ${VAR:-default}. Si la variable n'est pas définie ou est vide, la valeur par défaut est utilisée, ce qui permet à la pile de fonctionner sans fichier .env complet.

ports:
  - "${WEB_PORT:-80}:80"

Variables obligatoires

Utilisez ${VAR:?message} pour rendre une variable obligatoire. Compose s'interrompt avec votre message si elle est absente, ce qui permet de détecter rapidement une mauvaise configuration.

environment:
  API_KEY: ${API_KEY:?API_KEY must be set}

La directive env_file

Pour transmettre directement tout un fichier de variables à un conteneur (et pas seulement effectuer une substitution), utilisez env_file. Chaque ligne devient une variable d'environnement du conteneur.

services:
  api:
    image: myapi:1.0
    env_file:
      - api.env

Règles de priorité

Lorsqu’une variable est définie à plusieurs endroits, Compose applique un ordre de priorité. L’environnement du shell prime sur .env ; une entrée environment: explicite prime sur env_file.

Le shell / CLI -e est prioritaire
puis environment:
puis env_file
puis les valeurs par défaut de l’image

Inspecter les valeurs résolues

Exécutez docker compose config pour afficher le fichier Compose entièrement résolu, avec toutes les substitutions appliquées. C’est très utile pour vérifier ce qui sera réellement exécuté.

docker compose config

Exclure les secrets de Git

Validez un fichier .env.example contenant des valeurs fictives et ajoutez le véritable fichier .env à .gitignore. Pour les secrets réellement utilisés en production, préférez les secrets Docker aux variables d’environnement.

# .gitignore
.env

Vérification rapide

Comment les valeurs par défaut fonctionnent-elles lors d’une substitution ?

Récapitulatif

Vous savez maintenant configurer Compose proprement avec des données d’environnement :

environment: injecte des variables pour chaque service
Un fichier .env alimente la substitution ${VAR}
:- fournit des valeurs par défaut, tandis que :? signale les valeurs obligatoires
docker compose config affiche le résultat résolu

Un seul fichier Compose peut ainsi être utilisé dans tous les environnements.

Questions Fréquemment Posées

La leçon « Variables d’environnement et fichiers .env » est-elle gratuite ?

Oui — le texte complet de « Variables d’environnement et fichiers .env » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours DevOps Bootcamp, passe à CoddyKit PRO. Le cours DevOps Bootcamp comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Variables d’environnement et fichiers .env » ?

Configurez proprement les services Compose à l’aide de variables d’environnement, de la substitution de variables et d’un fichier .env, afin qu’un seul fichier Compose fonctionne en développement, en… Tu pratiques DevOps Bootcamp avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer DevOps Bootcamp ?

Aucune expérience préalable n'est requise. DevOps Bootcamp sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 4 sur 4.

Combien de temps prend la leçon « Variables d’environnement et fichiers .env » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon DevOps Bootcamp ?

Oui. Chaque leçon DevOps Bootcamp inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

Qu’est-ce que Docker Compose ?
Écrire un fichier Compose
Déployer des applications multiservices
Variables d’environnement et fichiers .env

← Retour à DevOps Bootcamp