# docker node ps

**Descripción:** Lista las tareas que se ejecutan en uno o más nodos; por defecto, en el nodo actual

**Uso:** `docker node ps [OPTIONS] [NODE...]`








**Orquestador:** Swarm

## Descripción

Lista todas las tareas en un nodo que Docker conoce. Puedes filtrar la salida usando la
opción `-f` o `--filter`. Consulta la sección de [filtrado](#filter) para obtener más
información sobre las opciones de filtro disponibles.

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


## Opciones

| Opción                                                        | Predeterminado                                        | Descripción                                                                                                                                    |
| ------------------------------------------------------------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | `-f`, `--filter` |  |  Filtra la salida según las condiciones proporcionadas |

 | `--format` |  |  Imprime las tareas de forma amigable utilizando una plantilla de Go |

 | `--no-resolve` |  |  No asocia IDs a nombres |

 | `--no-trunc` |  |  No trunca la salida |

 | `-q`, `--quiet` |  |  Solo muestra los IDs de las tareas |




## Ejemplos


```console
$ docker node ps swarm-manager1

NAME                                IMAGE        NODE            DESIRED STATE  CURRENT STATE
redis.1.7q92v0nr1hcgts2amcjyqg3pq   redis:7.4.1  swarm-manager1  Running        Running 5 hours
redis.6.b465edgho06e318egmgjbqo4o   redis:7.4.1  swarm-manager1  Running        Running 29 seconds
redis.7.bg8c07zzg87di2mufeq51a2qp   redis:7.4.1  swarm-manager1  Running        Running 5 seconds
redis.9.dkkual96p4bb3s6b10r7coxxt   redis:7.4.1  swarm-manager1  Running        Running 5 seconds
redis.10.0tgctg8h8cech4w0k0gwrmr23  redis:7.4.1  swarm-manager1  Running        Running 5 seconds
```

### Filtrado (--filter) {#filter}

El formato de la opción de filtrado (`-f` o `--filter`) es de "clave=valor". Si hay
más de un filtro, pasa múltiples opciones (por ejemplo, `--filter "foo=bar"
--filter "bif=baz"`).

Los filtros admitidos actualmente son:

* [name](#name)
* [id](#id)
* [label](#label)
* [desired-state](#desired-state)

#### name

El filtro `name` coincide con todo o parte del nombre de una tarea.

El siguiente filtro coincide con todas las tareas con un nombre que contiene la cadena `redis`.

```console
$ docker node ps -f name=redis swarm-manager1

NAME                                IMAGE        NODE            DESIRED STATE  CURRENT STATE
redis.1.7q92v0nr1hcgts2amcjyqg3pq   redis:7.4.1  swarm-manager1  Running        Running 5 hours
redis.6.b465edgho06e318egmgjbqo4o   redis:7.4.1  swarm-manager1  Running        Running 29 seconds
redis.7.bg8c07zzg87di2mufeq51a2qp   redis:7.4.1  swarm-manager1  Running        Running 5 seconds
redis.9.dkkual96p4bb3s6b10r7coxxt   redis:7.4.1  swarm-manager1  Running        Running 5 seconds
redis.10.0tgctg8h8cech4w0k0gwrmr23  redis:7.4.1  swarm-manager1  Running        Running 5 seconds
```

#### id

El filtro `id` coincide con el ID de una tarea.

```console
$ docker node ps -f id=bg8c07zzg87di2mufeq51a2qp swarm-manager1

NAME                                IMAGE        NODE            DESIRED STATE  CURRENT STATE
redis.7.bg8c07zzg87di2mufeq51a2qp   redis:7.4.1  swarm-manager1  Running        Running 5 seconds
```

#### label

El filtro `label` coincide con tareas basándose en la presencia de una `label` sola o una `label` y un
valor.

El siguiente filtro coincide con tareas que tienen la etiqueta `usage` independientemente de su valor.

```console
$ docker node ps -f "label=usage"

NAME                               IMAGE        NODE            DESIRED STATE  CURRENT STATE
redis.6.b465edgho06e318egmgjbqo4o  redis:7.4.1  swarm-manager1  Running        Running 10 minutes
redis.7.bg8c07zzg87di2mufeq51a2qp  redis:7.4.1  swarm-manager1  Running        Running 9 minutes
```


#### desired-state

El filtro `desired-state` puede tomar los valores `running`, `shutdown` o `accepted`.


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

Las opciones de formato (`--format`) imprimen la salida de las tareas utilizando
una plantilla de Go.

Los marcadores de posición válidos para la plantilla de Go se enumeran a continuación:

| Marcador de posición | Descripción |
| --- | --- |
| `.ID` | ID de la tarea |
| `.Name` | Nombre de la tarea |
| `.Image` | Imagen de la tarea |
| `.Node` | ID del nodo |
| `.DesiredState` | Estado deseado de la tarea (`running`, `shutdown` o `accepted`) |
| `.CurrentState` | Estado actual de la tarea |
| `.Error` | Error |
| `.Ports` | Puertos publicados de la tarea |

Cuando se utiliza la opción `--format`, el comando `node ps` mostrará
los datos exactamente como los declara la plantilla o, cuando se utiliza la
directiva `table`, también incluirá los encabezados de las columnas.

El siguiente ejemplo utiliza una plantilla sin encabezados y muestra los campos
`Name` y `Image` separados por dos puntos (`:`) para todas las tareas:

```console
$ docker node ps --format "{{.Name}}: {{.Image}}"

top.1: busybox
top.2: busybox
top.3: busybox
```