Comment utiliser la commande docker manifest rm pour supprimer des listes de manifestes

Introduction

Dans ce laboratoire (lab), vous apprendrez à gérer les listes de manifestes Docker, qui sont essentielles pour créer des images multi-architecture. Nous aborderons le processus de création d'une liste de manifestes en combinant des images pour différentes plateformes, la vérification de son existence à l'aide de la commande docker manifest inspect, et enfin, nous montrerons comment supprimer une liste de manifestes à l'aide de la commande docker manifest rm. Cette pratique pratiques vous offrira une expérience concrète dans la gestion des listes de manifestes au sein de votre flux de travail Docker.

Skills Graph

Créer une liste de manifestes

Dans cette étape, nous apprendrons à créer une liste de manifestes dans Docker. Une liste de manifestes est une liste de manifestes d'images, qui vous permet d'utiliser un seul nom d'image pour faire référence à des images destinées à différentes architectures et systèmes d'exploitation. Cela est particulièrement utile pour construire des images multi-architecture.

Tout d'abord, téléchargeons deux images différentes que nous utiliserons pour créer notre liste de manifestes. Nous utiliserons l'image alpine pour les architectures amd64 et arm64.

docker pull alpine:latest
docker pull --platform arm64 alpine:latest

La première commande télécharge l'image alpine:latest pour votre architecture actuelle (probablement amd64). La deuxième commande télécharge explicitement l'image alpine:latest pour l'architecture arm64.

Maintenant, nous pouvons créer la liste de manifestes à l'aide de la commande docker manifest create. La syntaxe est docker manifest create TARGET_IMAGE SOURCE_IMAGE [SOURCE_IMAGE...]. Nous allons créer une liste de manifestes nommée my-alpine:latest qui inclut les images alpine:latest pour les architectures amd64 et arm64.

docker manifest create my-alpine:latest alpine:latest alpine:latest --amend alpine:latest --platform arm64

Dans cette commande :

• my-alpine:latest est le nom de la nouvelle liste de manifestes que nous créons.
• alpine:latest est la première image source (pour l'architecture par défaut).
• --amend alpine:latest --platform arm64 ajoute l'image alpine:latest pour la plateforme arm64 à la liste de manifestes.

Après avoir exécuté cette commande, vous avez créé une liste de manifestes localement. Cependant, elle n'a pas encore été envoyée (push) à un registre. Nous l'enverrons à une étape ultérieure.

Vérifier l'existence de la liste de manifestes

Dans l'étape précédente, nous avons créé une liste de manifestes nommée my-alpine:latest. Maintenant, nous allons vérifier que cette liste de manifestes a été créée avec succès et qu'elle existe localement.

Nous pouvons utiliser la commande docker manifest inspect pour afficher les détails d'une liste de manifestes. Cette commande affichera le contenu de la liste de manifestes au format JSON si elle existe.

docker manifest inspect my-alpine:latest

Si la liste de manifestes my-alpine:latest a été créée avec succès, vous verrez une sortie JSON décrivant la liste de manifestes, y compris les différentes images auxquelles elle fait référence pour diverses architectures. Si la liste de manifestes n'existe pas, la commande renverra une erreur.

La sortie affichera des informations sur la liste de manifestes, telles que la version du schéma, le type média et une liste de manifestes pour chaque architecture incluse. Vous devriez voir des entrées pour les architectures amd64 et arm64, confirmant que la liste de manifestes a été créée correctement avec des références aux images pour ces plateformes.

Supprimer la liste de manifestes

Dans les étapes précédentes, nous avons créé et vérifié l'existence d'une liste de manifestes nommée my-alpine:latest. Maintenant, nous allons apprendre à supprimer cette liste de manifestes.

Pour supprimer une liste de manifestes, nous utilisons la commande docker manifest rm suivie du nom de la liste de manifestes.

docker manifest rm my-alpine:latest

Cette commande supprimera la référence locale à la liste de manifestes my-alpine:latest. Notez que cette commande ne supprime que la liste de manifestes elle - même, pas les images individuelles auxquelles la liste de manifestes fait référence. Les images alpine:latest pour les architectures amd64 et arm64 que nous avons téléchargées précédemment resteront toujours sur votre système.

Après avoir exécuté la commande, vous devriez voir une sortie indiquant que la liste de manifestes a été désétiquetée.

Vérifier que la liste de manifestes est supprimée

Dans l'étape précédente, nous avons supprimé la liste de manifestes nommée my-alpine:latest. Maintenant, nous allons vérifier que la liste de manifestes a été supprimée avec succès et n'existe plus localement.

Nous pouvons tenter d'inspecter à nouveau la liste de manifestes en utilisant la commande docker manifest inspect. Si la liste de manifestes a été supprimée avec succès, cette commande devrait renvoyer une erreur indiquant que la liste de manifestes n'a pas été trouvée.

docker manifest inspect my-alpine:latest

Lorsque vous exécutez cette commande après avoir supprimé la liste de manifestes, vous devriez voir un message d'erreur similaire à no such manifest: docker.io/library/my-alpine:latest. Cela confirme que la liste de manifestes a été supprimée de votre environnement Docker local.

Résumé

Dans ce laboratoire (lab), nous avons appris à créer et à gérer des listes de manifestes Docker. Nous avons commencé par télécharger des images pour différentes architectures, puis utilisé la commande docker manifest create pour les combiner en une seule liste de manifestes, démontrant ainsi comment construire des images multi-architectures.

Après la création, nous avons vérifié l'existence de la liste de manifestes à l'aide de la commande docker manifest inspect. Enfin, nous avons appris à supprimer la liste de manifestes en utilisant la commande docker manifest rm et avons confirmé sa suppression, couvrant ainsi la gestion essentielle du cycle de vie des listes de manifestes dans Docker.