Formations — 1 037 leçons en français

Accueil › Docker & conteneurs › Étiquettes et empreintes

Étiquettes et empreintes

Images et couchesdebutant

Deux façons de désigner une image. Elles n'offrent pas les mêmes garanties.

L'étiquette : un nom, pas une version

docker pull mon-api:1.4.2

Une étiquette est une entrée dans un dépôt, qui pointe vers un manifeste. Rien n'empêche de la faire pointer ailleurs demain, et rien ne le signale. latest n'est qu'une étiquette comme une autre, utilisée par défaut quand on n'en précise aucune.

L'empreinte : un contenu

docker pull mon-api@sha256:3f1c4d9ae2b7...

L'empreinte est calculée sur le manifeste de l'image — la liste de ses couches et sa configuration. Elle est immuable par construction : deux images de même empreinte sont le même contenu, sur n'importe quel registre.

Ce que ça change

Besoin Étiquette Empreinte
Lisible par un humain oui non
Même contenu à deux dates non garanti garanti
Retour arrière possible seulement si l'ancienne étiquette existe encore toujours
Audit « qu'est-ce qui tournait ce jour-là ? » impossible direct

On étiquette pour les humains et on déploie par empreinte. La chaîne d'intégration publie une étiquette de version, lit l'empreinte obtenue, et l'écrit dans le manifeste de déploiement.

Les termes à connaître

Étiquette

Un nom lisible attaché à une image dans un dépôt. Elle est mobile : rien n'empêche de la faire désigner un autre contenu, et rien ne le signale.

Empreinte

L'identifiant sha256 calculé sur le manifeste de l'image. Immuable par construction : une empreinte désigne toujours le même contenu.

Manifeste

Le document qui décrit une image : la liste de ses couches, sa configuration, son architecture. C'est lui dont on calcule l'empreinte.

Index d'images

Un manifeste qui en référence plusieurs, un par architecture. C'est ce qui permet à une même étiquette de fonctionner sur des processeurs différents.

Étiquette mobile

Une étiquette réécrite à chaque publication — latest, un nom de branche, un numéro de version majeure. Pratique à lire, impossible à auditer.

Reproductibilité du déploiement

La garantie que deux déploiements de la même référence livrent le même contenu. Seule l'empreinte l'assure.

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.