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...] |
Swarm Este comando funciona con el orquestador de 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 para obtener más
información sobre las opciones de filtro disponibles.
NoteEste 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 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
$ 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)
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
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.
$ 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.
$ 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.
$ 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)
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:
$ docker node ps --format "{{.Name}}: {{.Image}}"
top.1: busybox
top.2: busybox
top.3: busybox