# docker stack ls

**Descripción:** Lista las pilas (stacks)

**Uso:** `docker stack ls [OPTIONS]`

**Alias:** `docker stack list`






**Orquestador:** Swarm

## Descripción

Lista las pilas (stacks).

> [!NOTE]
> Este es un comando de administración de clústeres y debe ejecutarse en un
> nodo administrador (manager) de swarm. Para obtener información sobre nodos administradores y trabajadores, consulta la
> [sección del modo Swarm](/engine/swarm/) en la
> documentación.


## Opciones

| Opción                                                        | Predeterminado                                        | Descripción                                                                                                                                    |
| ------------------------------------------------------------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | `--format` |  |  Da formato a la salida utilizando una plantilla personalizada:<br>'table':            Muestra la salida en formato de tabla con encabezados de columna (predeterminado)<br>'table TEMPLATE':   Muestra la salida en formato de tabla utilizando la plantilla de Go especificada<br>'json':             Muestra la salida en formato JSON<br>'TEMPLATE':         Muestra la salida utilizando la plantilla de Go especificada.<br>Consulta https://docs-docker.esdocu.com/go/formatting/ para obtener más información sobre cómo dar formato a la salida con plantillas |




## Ejemplos

El siguiente comando muestra todas las pilas (stacks) y algo de información adicional:

```console
$ docker stack ls

ID                 SERVICES            ORCHESTRATOR
myapp              2                   Kubernetes
vossibility-stack  6                   Swarm
```

### Dar formato a la salida (--format) {#format}

La opción de formato (`--format`) muestra las pilas de manera atractiva utilizando una plantilla de Go.

A continuación se enumeran los marcadores de posición (placeholders) válidos para la plantilla de Go:

| Marcador de posición | Descripción |
|-----------------|--------------------|
| `.Name`         | Nombre de la pila |
| `.Services`     | Número de servicios |
| `.Orchestrator` | Nombre del orquestador |
| `.Namespace`    | Espacio de nombres (Namespace) |

Al usar la opción `--format`, el comando `stack ls` muestra los datos exactamente como los declara la plantilla o, cuando se utiliza la directiva `table`, también incluye los encabezados de las columnas.

El siguiente ejemplo utiliza una plantilla sin encabezados y muestra las entradas `Name` y `Services` separadas por dos puntos (`:`) para todas las pilas:

```console
$ docker stack ls --format "{{.Name}}: {{.Services}}"
web-server: 1
web-cache: 4
```

Para listar todas las pilas en formato JSON, utiliza la directiva `json`:

```console
$ docker stack ls --format json
{"Name":"myapp","Namespace":"","Orchestrator":"Swarm","Services":"3"}
```