Formations — 1 037 leçons en français

Accueil › Docker & conteneurs › Nommer et versionner une image

Nommer et versionner une image

Registre et publicationintermediaire

Une référence d'image n'est pas un nom libre. C'est une adresse en trois parties, lue de gauche à droite.

registre.interne:5000 / equipe/api/web : 2.1.0
└──── hôte ─────────┘  └── dépôt ────┘  └ étiquette ┘

Les trois parties

L'hôte est facultatif. Le premier segment n'est reconnu comme un registre que s'il contient un point, un deux-points, ou qu'il vaut localhost. Sinon, il fait partie du dépôt et le moteur complète la référence avec son registre par défaut.

Le dépôt est un chemin, pas un mot : equipe/api/web est un seul dépôt à trois segments. Il regroupe toutes les versions d'une même image.

La fin de la référence est soit une étiquette, introduite par :, soit une empreinte, introduite par @ :

docker pull registre.interne:5000/equipe/api/web:2.1.0
docker pull registre.interne:5000/equipe/api/web@sha256:3f1c4d...

Le piège du découpage

Découper sur le dernier : paraît suffisant. Ça ne l'est pas : le port du registre contient aussi un deux-points. Pour registre.interne:5000/equipe/api/web, sans étiquette, ce découpage naïf conclut à une étiquette 5000/equipe/api/web. La règle correcte est de ne chercher le séparateur d'étiquette qu'après la dernière barre oblique.

Versionner

On publie une version complète figée, et on fait suivre les étiquettes mobiles. 2.1.0 ne bouge plus jamais. 2.1, 2 et latest désignent le dernier contenu de leur ligne.

Les termes à connaître

Référence d'image

La chaîne complète qui désigne une image. Elle se compose d'un hôte de registre facultatif, d'un chemin de dépôt, puis d'une étiquette ou d'une empreinte.

Dépôt

Le chemin qui regroupe toutes les versions d'une même image dans un registre. Il peut être imbriqué sur plusieurs segments séparés par des barres obliques.

Registre par défaut

Le registre utilisé quand la référence ne nomme aucun hôte. Le moteur complète alors silencieusement la référence, ce qui surprend quand on héberge son propre registre.

Étiquette figée

Une étiquette qui, une fois publiée, ne doit plus jamais désigner un autre contenu. Elle sert de point de repère vérifiable dans l'historique.

Étiquette mobile

Une étiquette délibérément réécrite à chaque publication — latest, un numéro de version majeure, un nom de branche. Lisible, mais sans garantie de contenu.

Référence par empreinte

Une référence de la forme depot@sha256:…, qui désigne un manifeste précis. Elle n'a pas d'étiquette et ne peut pas être déplacée.

Préversion

Une version publiée pour être essayée avant la version stable, marquée par un suffixe sur l'étiquette. Elle n'est pas candidate à l'étiquetage mobile de production.

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.