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:conteneurqui 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.
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.