Formations — 1 037 leçons en français

Accueil › Docker & conteneurs › Publier des ports, passer la configuration

Publier des ports, passer la configuration

Exécuter un conteneurdebutant

Un conteneur a sa propre pile réseau. Par défaut, rien n'entre. Pour qu'une requête venue de la machine atteigne l'application, on publie un port.

docker run -d -p 8080:3000 mon-api:1.4
#              ^^^^ ^^^^
#              hôte conteneur

L'ordre est toujours hôte, puis conteneur, et il ne s'inverse pas. Le port du conteneur est imposé par le code de l'application : si elle écoute sur 3000, c'est 3000 à droite. Le port de l'hôte, lui, est libre — on choisit celui qui n'est pas déjà pris.

La configuration passe par l'environnement

Une image est la même en développement et en production. Ce qui change, ce sont les valeurs qu'on lui passe au démarrage :

docker run -d \
  -p 8080:3000 \
  -e NODE_ENV=production \
  -e DATABASE_URL=postgres://db:5432/app \
  mon-api:1.4

Côté Node, ces valeurs arrivent dans process.env. Côté Java, dans System.getenv. Le même binaire, trois environnements, zéro recompilation.

Deux erreurs qui ne disent rien

Inverser les deux ports ouvre bien un port sur l'hôte, mais sur le vide. Et une application qui écoute sur la boucle locale du conteneur est injoignable malgré une publication correcte. Dans les deux cas, le conteneur démarre, les journaux sont normaux, et la connexion est refusée.

Les termes à connaître

Publication de port

L'option -p hote:conteneur qui demande au démon de rediriger un port de la machine vers un port du conteneur. Sans elle, rien n'entre depuis l'extérieur.

Port de l'hôte

Le port sur lequel on se connecte depuis la machine. Il doit être libre, et il est le seul des deux que le client voit.

Port du conteneur

Le port sur lequel l'application écoute à l'intérieur. Il est fixé par le code, pas par Docker.

EXPOSE

Une instruction de recette purement documentaire. Elle déclare un port d'écoute, elle ne publie rien.

Variable d'environnement

Une paire clé-valeur passée au processus au démarrage. C'est le canal standard de configuration d'un conteneur.

Fichier d'environnement

Un fichier de paires clé-valeur passé avec --env-file, pour éviter d'écrire les valeurs dans la ligne de commande.

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.