Accueil › Docker & conteneurs › Publier un port, ou simplement l'exposer
Publier un port, ou simplement l'exposer
Le réseau des conteneursintermediaire
Deux mots qui se ressemblent et ne font pas la même chose.
Publier : cela ouvre un chemin
docker run -d -p 8080:3000 --name api mon-api
curl http://localhost:8080/sante # depuis l'hôte
Le moteur fait suivre le trafic arrivant sur le port 8080 de l'hôte vers le port 3000 du conteneur. À gauche l'hôte, à droite le conteneur.
Exposer : cela ne fait rien
EXPOSE 3000
Une métadonnée inscrite dans l'image. Elle documente le port du service, et
sert de source à l'option -P qui publie tous les ports exposés sur des ports
d'hôte attribués automatiquement. Seule, elle n'ouvre rien.
Entre conteneurs, la publication ne sert à rien
docker network create appli
docker run -d --name base --network appli postgres:17 # aucun -p
docker run -d --name api --network appli mon-api
# dans api : postgres://base:5432/app
La base n'a aucun port publié et l'API la joint sans difficulté : sur un réseau commun, c'est le port du conteneur qui compte.
Le bouclage désigne le conteneur
Dans un conteneur, localhost et 127.0.0.1 désignent ce conteneur. Jamais
l'hôte, jamais un voisin.
| Origine de l'appel | Adresse et port |
|---|---|
| hôte | localhost:8080, le port publié |
| autre conteneur du réseau | api:3000, le port du conteneur |
| extérieur | adresse de la machine, port publié |
| le conteneur lui-même | localhost:3000 |
Les termes à connaître
- Publier un port
L'option
-p hote:conteneur, qui fait suivre le trafic arrivant sur un port de l'hôte vers un port du conteneur. C'est la seule façon de rendre un conteneur joignable depuis l'extérieur de son réseau.- Exposer un port
L'instruction
EXPOSEd'une recette, ou la cléexposede compose. C'est une documentation : elle n'ouvre rien et ne fait suivre aucun trafic.- Adresse d'écoute
L'adresse sur laquelle un serveur attend les connexions. Un service qui n'écoute que sur 127.0.0.1 dans un conteneur n'est joignable par personne d'autre que lui-même.
- Adresse de publication
La partie facultative avant le port d'hôte dans
-p. Sans elle, le port est ouvert sur toutes les interfaces de la machine ; avec127.0.0.1:, il reste local.- Port du conteneur
Le port sur lequel le service écoute dans son espace réseau. C'est lui, et lui seul, qu'utilise un autre conteneur du même réseau.
- Nom d'hôte spécial de l'hôte
Le nom
host.docker.internal, résolu vers l'hôte depuis un conteneur. Disponible d'office sur les installations de bureau ; sur un moteur Linux il se demande explicitement.
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.