Comment utiliser la commande docker buildx du pour vérifier l'utilisation du disque

Introduction

Dans ce lab, vous apprendrez à utiliser efficacement la commande docker buildx du pour inspecter et comprendre l'utilisation du disque de votre cache de construction Docker. Vous commencerez par vérifier l'utilisation de base du disque pour votre builder actuel et comprendrez la signification des colonnes de sortie, notamment CACHE ID, SIZE et LAST ACCESSED.

De plus, vous explorerez comment utiliser la sortie détaillée pour obtenir des informations plus précises sur les enregistrements individuels du cache et apprendrez à vérifier l'utilisation du disque pour une instance spécifique de builder, vous permettant ainsi de gérer et d'optimiser plus efficacement votre cache de construction.

Skills Graph

Afficher l'utilisation du disque pour le builder actuel

Dans cette étape, vous apprendrez comment vérifier l'utilisation du disque de votre builder Docker actuel. La commande docker buildx du est utilisée pour afficher l'utilisation du disque par le cache de build. Cela est utile pour comprendre l'espace consommé par votre cache de build et identifier les éventuelles zones à nettoyer.

Commencez par exécuter la commande docker buildx du sans options pour voir les informations de base sur l'utilisation du disque pour le builder actuel.

docker buildx du

Vous devriez voir une sortie similaire à ceci, montrant la taille totale du cache de build. La taille exacte variera en fonction de vos activités de build précédentes.

CACHE ID                                    SIZE      LAST ACCESSED
... (la sortie peut varier)
TOTAL: 123.4MB

La sortie affiche une liste d'entrées de cache avec leur ID, leur taille et leur date de dernier accès. La ligne TOTAL à la fin indique l'espace disque total utilisé par le cache de build pour le builder actuel.

Comprendre la sortie de docker buildx du

Dans l'étape précédente, vous avez exécuté la commande docker buildx du et vu une sortie affichant des entrées de cache ainsi qu'une taille totale. Dans cette étape, nous allons approfondir la compréhension des différentes colonnes de cette sortie.

Examinons à nouveau la sortie :

CACHE ID                                    SIZE      LAST ACCESSED
... (la sortie peut varier)
TOTAL: 123.4MB

• CACHE ID : Il s'agit d'un identifiant unique pour chaque entrée de cache. Ces ID sont générés par BuildKit et représentent différentes couches ou étapes de votre processus de build qui ont été mises en cache.
• SIZE : Cette colonne indique la taille de l'entrée de cache spécifique. C'est l'espace disque consommé par cette couche ou étape particulière mise en cache.
• LAST ACCESSED : Ce champ indique la dernière fois que cette entrée de cache a été utilisée lors d'un build. Cette information est utile pour identifier les entrées de cache qui ne sont plus activement utilisées et pourraient potentiellement être supprimées pour libérer de l'espace.

La ligne TOTAL en bas fournit la somme des tailles de toutes les entrées de cache listées, vous donnant ainsi l'utilisation globale du disque par le cache de build pour le builder actuel. Comprendre ces colonnes vous aide à analyser votre cache de build et à gérer efficacement sa taille.

Utiliser le mode verbeux pour inspecter les enregistrements d'utilisation du disque

Dans cette étape, vous apprendrez comment obtenir des informations plus détaillées sur les entrées du cache de build en utilisant l'option de sortie verbeuse avec la commande docker buildx du. La sortie verbeuse fournit des détails supplémentaires utiles pour le débogage et la compréhension de l'origine des couches en cache.

Pour obtenir une sortie verbeuse, utilisez l'option -v ou --verbose avec la commande docker buildx du :

docker buildx du -v

La sortie contiendra désormais plus de colonnes, telles que USAGE, DESCRIPTION, et potentiellement d'autres selon le type d'entrée de cache.

CACHE ID                                    SIZE      LAST ACCESSED   USAGE     DESCRIPTION
... (la sortie peut varier)
TOTAL: 123.4MB

• USAGE : Cette colonne peut fournir des informations sur la manière dont l'entrée de cache est utilisée ou référencée.
• DESCRIPTION : Cette colonne contient souvent une description de l'étape de build ou de l'instruction qui a généré cette entrée de cache. Ceci est très utile pour identifier quelles parties de votre Dockerfile ou processus de build contribuent à la taille du cache.

En examinant la colonne DESCRIPTION dans la sortie verbeuse, vous pouvez voir quelles instructions de build spécifiques (comme RUN, COPY, etc.) correspondent à chaque entrée de cache. Cela vous aide à comprendre la structure de votre cache de build et à identifier les zones où vous pourriez optimiser votre Dockerfile pour réduire la taille du cache.

Vérifier l'utilisation du disque pour une instance de builder spécifique

Dans cette étape, vous apprendrez comment vérifier l'utilisation du disque pour une instance spécifique de Docker builder. Par défaut, docker buildx du affiche l'utilisation du disque pour le builder actuellement actif. Cependant, vous pourriez avoir plusieurs instances de builder configurées et souhaiter inspecter l'utilisation du cache pour une autre instance.

Commencez par lister les instances de builder disponibles pour identifier celle que vous souhaitez inspecter. Vous pouvez le faire avec la commande docker buildx ls :

docker buildx ls

La sortie affichera une liste de vos instances de builder. Cherchez la colonne NAME pour identifier le nom du builder qui vous intéresse. Le builder actuellement actif sera marqué d'un astérisque (*).

NAME/NODE       DRIVER/ENDPOINT             STATUS   BUILDKIT             PLATFORMS
default *       docker                      running  v0.10.5+a34f333b1f   linux/amd64, linux/arm64, linux/riscv64, linux/ppc64le, linux/s390x, linux/386, linux/arm/v7, linux/arm/v6
mybuilder       docker-container            running  v0.10.5+a34f333b1f   linux/amd64, linux/arm64, linux/riscv64, linux/ppc64le, linux/s390x, linux/386, linux/arm/v7, linux/arm/v6

Pour vérifier l'utilisation du disque pour une instance de builder spécifique, utilisez l'option --builder suivie du nom du builder. Par exemple, si vous avez un builder nommé mybuilder, exécutez :

docker buildx du --builder mybuilder

Remplacez mybuilder par le nom réel de l'instance de builder que vous souhaitez inspecter. Cette commande affichera l'utilisation du disque spécifiquement pour le cache associé à cette instance de builder. Ceci est utile si vous travaillez avec différentes configurations de builder ou si vous souhaitez isoler l'utilisation du cache d'un environnement de build particulier.

Résumé

Dans ce lab, vous avez appris à utiliser la commande docker buildx du pour vérifier l'utilisation du disque par votre cache de build Docker. Vous avez commencé par exécuter la commande de base pour voir la taille totale et une liste des entrées du cache.

Vous avez ensuite approfondi votre compréhension des colonnes de sortie, notamment CACHE ID, SIZE et LAST ACCESSED, qui fournissent des détails sur chaque entrée du cache. Vous avez également exploré comment utiliser la sortie verbeuse (-v) pour afficher des enregistrements plus détaillés pour chaque entrée du cache, et appris à vérifier l'utilisation du disque pour une instance de builder spécifique en précisant son nom.