# 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.

```console
$ 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://ubuntu@1.2.3.4          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) {#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 (`:`):

```console
$ docker buildx ls --format "{{.Name}}: {{.DriverEndpoint}}"
elated_tesla: docker-container
elated_tesla0: unix:///var/run/docker.sock
elated_tesla1: ssh://ubuntu@1.2.3.4
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:

```console
$ 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://ubuntu@1.2.3.4
  default: docker
  default: default
```