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