Formations — 1 037 leçons en français

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 EXPOSE d'une recette, ou la clé expose de 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 ; avec 127.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.

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.