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