Gestionar builders

Tabla de contenidos

Puedes crear, inspeccionar y gestionar builders utilizando los comandos docker buildx, o bien utilizando Docker Desktop.

Crear un nuevo builder

El builder predeterminado utiliza el driver docker. No puedes crear builders docker de forma manual, pero sí puedes crear builders que utilicen otros drivers, como el driver docker-container, el cual ejecuta el demonio de BuildKit en un contenedor.

Usa el comando docker buildx create para crear un builder.

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

Buildx utiliza el driver docker-container por defecto si omites la bandera --driver. Para obtener más información sobre los drivers disponibles, consulta Drivers de compilación.

Listar los builders disponibles

Usa el comando docker buildx ls para ver las instancias de builders disponibles en tu sistema y los drivers que están utilizando.

$ 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

El asterisco (*) junto al nombre del builder indica cuál es el builder seleccionado.

Inspeccionar un builder

Para inspeccionar un builder con la CLI, usa el comando docker buildx inspect <nombre>. Solo puedes inspeccionar un builder si este está activo. Puedes añadir la bandera --bootstrap al comando para iniciar el 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 deseas ver cuánto espacio en disco está utilizando un builder, usa el comando docker buildx du. De forma predeterminada, este comando muestra el uso total de disco para todos los builders disponibles. Para ver el uso de un builder específico, utiliza la bandera --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

Eliminar un builder

Usa el comando docker buildx rm para eliminar un builder.

$ docker buildx rm <builder-name>

Si eliminas el builder seleccionado actualmente, se seleccionará automáticamente el builder predeterminado docker. No puedes eliminar el builder predeterminado.

También se eliminará la caché de compilación local del builder.

Eliminar builders remotos

Eliminar un builder remoto no afecta a su caché de compilación remota. Tampoco detiene el demonio de BuildKit remoto. Solo elimina la conexión a dicho builder.