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

Gérer les builders

Table des matières

Vous pouvez créer, inspecter et gérer des builders à l'aide des commandes docker buildx, ou en utilisant Docker Desktop.

Créer un nouveau builder

Le builder par défaut utilise le pilote docker. Vous ne pouvez pas créer manuellement de nouveaux builders docker, mais vous pouvez créer des builders qui utilisent d'autres pilotes, tels que le pilote docker-container, qui exécute le démon BuildKit dans un conteneur.

Utilisez la commande docker buildx create pour créer un builder.

$ docker buildx create --name=<builder-name>

Buildx utilise le pilote docker-container par défaut si vous omettez l'indicateur --driver. Pour plus d'informations sur les pilotes disponibles, consultez Pilotes de build.

Lister les builders disponibles

Utilisez docker buildx ls pour voir les instances de builder disponibles sur votre système, et les pilotes qu'ils utilisent.

$ docker buildx ls
NAME/NODE       DRIVER/ENDPOINT      STATUS   BUILDKIT PLATFORMS
default *       docker
  default       default              running  v0.11.6  linux/amd64, linux/amd64/v2, linux/amd64/v3, linux/386
my_builder      docker-container
  my_builder0   default              running  v0.11.6  linux/amd64, linux/amd64/v2, linux/amd64/v3, linux/386

L'astérisque (*) à côté du nom du builder indique le builder sélectionné.

Inspecter un builder

Pour inspecter un builder avec la CLI, utilisez docker buildx inspect <name>. Vous ne pouvez inspecter un builder que si le builder est actif. Vous pouvez ajouter l'indicateur --bootstrap à la commande pour démarrer le builder.

$ docker buildx inspect --bootstrap my_builder
[+] Building 1.7s (1/1) FINISHED                                                                  
 => [internal] booting buildkit                                                              1.7s
 => => pulling image moby/buildkit:buildx-stable-1                                           1.3s
 => => creating container buildx_buildkit_my_builder0                                        0.4s
Name:          my_builder
Driver:        docker-container
Last Activity: 2023-06-21 18:28:37 +0000 UTC

Nodes:
Name:      my_builder0
Endpoint:  unix:///var/run/docker.sock
Status:    running
Buildkit:  v0.11.6
Platforms: linux/arm64, linux/amd64, linux/amd64/v2, linux/riscv64, linux/ppc64le, linux/s390x, linux/386, linux/mips64le, linux/mips64, linux/arm/v7, linux/arm/v6

Si vous souhaitez voir l'espace disque qu'un builder utilise, utilisez la commande docker buildx du. Par défaut, cette commande affiche l'utilisation totale du disque pour tous les builders disponibles. Pour voir l'utilisation d'un builder spécifique, utilisez l'indicateur --builder.

$ docker buildx du --builder my_builder
ID                                        RECLAIMABLE SIZE        LAST ACCESSED
olkri5gq6zsh8q2819i69aq6l                 true        797.2MB     37 seconds ago
6km4kasxgsywxkm6cxybdumbb*                true        438.5MB     36 seconds ago
qh3wwwda7gx2s5u4hsk0kp4w7                 true        213.8MB     37 seconds ago
54qq1egqem8max3lxq6180cj8                 true        200.2MB     37 seconds ago
ndlp969ku0950bmrw9muolw0c*                true        116.7MB     37 seconds ago
u52rcsnfd1brwc0chwsesb3io*                true        116.7MB     37 seconds ago
rzoeay0s4nmss8ub59z6lwj7d                 true        46.25MB     4 minutes ago
itk1iibhmv7awmidiwbef633q                 true        33.33MB     37 seconds ago
4p78yqnbmgt6xhcxqitdieeln                 true        19.46MB     4 minutes ago
dgkjvv4ay0szmr9bl7ynla7fy*                true        19.24MB     36 seconds ago
tuep198kmcw299qc9e4d1a8q2                 true        8.663MB     4 minutes ago
n1wzhauk9rpmt6ib1es7dktvj                 true        20.7kB      4 minutes ago
0a2xfhinvndki99y69157udlm                 true        16.56kB     37 seconds ago
gf0z1ypz54npfererqfeyhinn                 true        16.38kB     37 seconds ago
nz505f12cnsu739dw2pw0q78c                 true        8.192kB     37 seconds ago
hwpcyq5hdfvioltmkxu7fzwhb*                true        8.192kB     37 seconds ago
acekq89snc7j6im1rjdizvsg1*                true        8.192kB     37 seconds ago
Reclaimable:  2.01GB
Total:        2.01GB

Supprimer un builder

Utilisez la commande docker buildx remove pour supprimer un builder.

$ docker buildx rm <builder-name>

Si vous supprimez votre builder actuellement sélectionné, le builder docker par défaut est automatiquement sélectionné. Vous ne pouvez pas supprimer le builder par défaut.

Le cache de build local pour le builder est également supprimé.

Suppression de builders distants

La suppression d'un builder distant n'affecte pas le cache de build distant. Elle n'arrête pas non plus le démon BuildKit distant. Elle supprime uniquement votre connexion au builder.

Gérer les builders avec Docker Desktop

Si vous avez activé la vue Builds de Docker Desktop, vous pouvez inspecter les builders dans les paramètres de Docker Desktop.