docker buildx ls
| Descripción | Lista las instancias de builder |
|---|---|
| Uso | docker buildx ls |
Descripción
Lista todas las instancias de builder y los nodos de cada instancia.
$ docker buildx ls
NAME/NODE DRIVER/ENDPOINT STATUS BUILDKIT PLATFORMS
elated_tesla* docker-container
\_ elated_tesla0 \_ unix:///var/run/docker.sock running v0.10.3 linux/amd64
\_ elated_tesla1 \_ ssh://[email protected] running v0.10.3 linux/arm64*, linux/arm/v7, linux/arm/v6
default docker
\_ default \_ default running v0.8.2 linux/amd64
Cada builder tiene uno o más nodos asociados. El nombre del builder actual está
marcado con un * en NAME/NODE y el nodo explícito sobre el que compilar para la
plataforma de destino está marcado con un * en la columna PLATFORMS.
Opciones
| Opción | Predeterminado | Descripción |
|---|---|---|
--format | table | Formatea la salida |
--no-trunc | No trunca la salida | |
--timeout | 20s | Sobrescribe el tiempo de espera (timeout) predeterminado para cargar el estado del builder |
Ejemplos
Formatear la salida (--format)
Las opciones de formato (--format) imprimen con un formato amigable la salida de las instancias
de builder utilizando una plantilla de Go.
A continuación se enumeran los marcadores de posición válidos para la plantilla de Go:
| Marcador de posición | Descripción |
|---|---|
.Name | Nombre del builder o del nodo |
.DriverEndpoint | Controlado (para el builder) o Punto de conexión/Endpoint (para el nodo) |
.LastActivity | Última actividad del builder |
.Status | Estado del builder o del nodo |
.Buildkit | Versión de BuildKit del nodo |
.Platforms | Plataformas disponibles para el nodo |
.Error | Error |
.Builder | Objeto del builder |
Al usar la opción --format, el comando ls producirá los datos exactamente
como lo declara la plantilla o, si se usa la directiva table, también incluirá
los encabezados de las columnas.
El siguiente ejemplo utiliza una plantilla sin encabezados y muestra las entradas de
Name y DriverEndpoint separadas por dos puntos (:):
$ docker buildx ls --format "{{.Name}}: {{.DriverEndpoint}}"
elated_tesla: docker-container
elated_tesla0: unix:///var/run/docker.sock
elated_tesla1: ssh://[email protected]
default: docker
default: default
El marcador de posición Builder se puede utilizar para acceder al objeto builder y a sus
campos. Por ejemplo, la siguiente plantilla muestra los nombres de los builders y de sus
nodos con sus puntos de conexión correspondientes:
$ docker buildx ls --format "{{.Builder.Name}}: {{range .Builder.Nodes}}\n {{.Name}}: {{.Endpoint}}{{end}}"
elated_tesla:
elated_tesla0: unix:///var/run/docker.sock
elated_tesla1: ssh://[email protected]
default: docker
default: default