Accueil › Docker & conteneurs › Pousser dans un registre
Pousser dans un registre
Registre et publicationintermediaire
Publier une image, c'est déposer des couches et un manifeste dans un registre, sous une référence. L'opération est plus fine qu'une copie de fichier.
docker login registre.interne
docker push registre.interne/equipe/api:2.1.0
Ce qui part sur le réseau
Le client demande au registre, couche par couche, s'il possède déjà l'empreinte concernée. Il ne transmet que ce qui manque, puis dépose le manifeste. Deux conséquences pratiques : republier une image dont seule la dernière couche a changé est rapide, et un découpage en couches bien ordonné économise du réseau à chaque publication.
Une étiquette par commande
docker push registre.interne/equipe/api:2.1.0
docker push registre.interne/equipe/api:2.1
docker push registre.interne/equipe/api:latest
Les trois commandes ne retransmettent pas les couches : le registre les a déjà. Seul un nouveau pointeur d'étiquette est créé. Oublier la deuxième ou la troisième laisse une étiquette mobile figée sur une version ancienne, sans aucun signal.
Droits d'écriture
Les identifiants de publication donnent le droit de réécrire des étiquettes existantes. Ils méritent un jeton dédié, limité au dépôt visé, de courte durée, et jamais inscrit dans un fichier versionné.
Les termes à connaître
- Registre
Le service qui stocke et distribue les images. Il expose une interface normalisée que tous les moteurs savent interroger, quel que soit l'hébergeur.
- Envoi par couche
La publication ne transmet que les couches que le registre ne possède pas déjà. Les autres sont simplement référencées par leur empreinte.
- Identifiants de publication
Les éléments d'authentification qui autorisent l'écriture dans un dépôt. Ils sont stockés par le client, et c'est ce stockage qu'il faut surveiller.
- Jeton éphémère
Un identifiant de courte durée, émis pour une chaîne d'intégration donnée, qui expire seul. Il remplace un mot de passe permanent inscrit dans la configuration.
- Immuabilité des étiquettes
Un réglage de registre qui refuse l'écriture sur une étiquette déjà publiée. C'est le seul mécanisme qui empêche vraiment de déplacer une version figée.
- Promotion
Le transfert d'une image déjà construite d'un dépôt vers un autre, sans reconstruction. L'empreinte est conservée, donc le contenu est prouvé identique.
- Miroir de tirage
Un registre intermédiaire qui met en cache les images publiques. Il réduit la dépendance au réseau externe et aux limites de débit du registre d'origine.
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.