⚠️ Traduction non officielle - Cette documentation est une traduction communautaire non officielle de Docker.

Étiquettes sur Docker Hub

Les étiquettes vous permettent de gérer plusieurs versions d'images au sein d'un seul dépôt Docker Hub. En ajoutant une :<tag> spécifique à chaque image, comme docs/base:testing, vous pouvez organiser et différencier les versions d'images pour divers cas d'usage. Si aucune étiquette n'est spécifiée, l'image utilise par défaut l'étiquette latest.

Étiqueter une image locale

Pour étiqueter une image locale, utilisez l'une des méthodes suivantes :

  • Lorsque vous construisez une image, utilisez docker build -t <org-ou-utilisateur-namespace>/<nom-repo>[:<tag>.
  • Re-étiquetez une image locale existante avec docker tag <image-existante> <org-ou-utilisateur-namespace>/<nom-repo>[:<tag>].
  • Lorsque vous validez les changements, utilisez docker commit <conteneur-existant> <org-ou-utilisateur-namespace>/<nom-repo>[:<tag>].

Ensuite, vous pouvez pousser cette image vers le dépôt désigné par son nom ou son étiquette :

$ docker push <org-ou-utilisateur-namespace>/<nom-repo>:<tag>

L'image est alors téléchargée et disponible pour utilisation dans Docker Hub.

Voir les étiquettes de dépôt

Vous pouvez voir les étiquettes disponibles et la taille de l'image associée.

  1. Connectez-vous à Docker Hub.

  2. Sélectionnez Mon Hub > Dépôts.

    Une liste de vos dépôts apparaît.

  3. Sélectionnez un dépôt.

    La page Général du dépôt apparaît.

  4. Sélectionnez l'onglet Étiquettes.

Vous pouvez sélectionner le digest d'une étiquette pour voir plus de détails.

Supprimer les étiquettes de dépôt

Seul le propriétaire du dépôt ou d'autres membres de l'équipe avec des permissions accordées peuvent supprimer les étiquettes.

  1. Connectez-vous à Docker Hub.

  2. Sélectionnez Mon Hub > Dépôts.

    Une liste de vos dépôts apparaît.

  3. Sélectionnez un dépôt.

    La page Général du dépôt apparaît.

  4. Sélectionnez l'onglet Étiquettes.

  5. Sélectionnez la case à cocher correspondante à côté des étiquettes à supprimer.

  6. Sélectionnez Supprimer.

    Une boîte de dialogue de confirmation apparaît.

  7. Sélectionnez Supprimer.