github.com/kelda-inc/moby@v1.13.1/docs/reference/commandline/node_ps.md (about) 1 --- 2 title: "node ps" 3 description: "The node ps command description and usage" 4 keywords: node, tasks, ps 5 aliases: ["/engine/reference/commandline/node_tasks/"] 6 --- 7 8 <!-- This file is maintained within the docker/docker Github 9 repository at https://github.com/docker/docker/. Make all 10 pull requests against that repo. If you see this file in 11 another repository, consider it read-only there, as it will 12 periodically be overwritten by the definitive file. Pull 13 requests which include edits to this file in other repositories 14 will be rejected. 15 --> 16 17 # node ps 18 19 ```markdown 20 Usage: docker node ps [OPTIONS] [NODE...] 21 22 List tasks running on one or more nodes, defaults to current node. 23 24 Options: 25 -f, --filter value Filter output based on conditions provided 26 --help Print usage 27 --no-resolve Do not map IDs to Names 28 --no-trunc Do not truncate output 29 ``` 30 31 Lists all the tasks on a Node that Docker knows about. You can filter using the `-f` or `--filter` flag. Refer to the [filtering](#filtering) section for more information about available filter options. 32 33 Example output: 34 35 $ docker node ps swarm-manager1 36 NAME IMAGE NODE DESIRED STATE CURRENT STATE 37 redis.1.7q92v0nr1hcgts2amcjyqg3pq redis:3.0.6 swarm-manager1 Running Running 5 hours 38 redis.6.b465edgho06e318egmgjbqo4o redis:3.0.6 swarm-manager1 Running Running 29 seconds 39 redis.7.bg8c07zzg87di2mufeq51a2qp redis:3.0.6 swarm-manager1 Running Running 5 seconds 40 redis.9.dkkual96p4bb3s6b10r7coxxt redis:3.0.6 swarm-manager1 Running Running 5 seconds 41 redis.10.0tgctg8h8cech4w0k0gwrmr23 redis:3.0.6 swarm-manager1 Running Running 5 seconds 42 43 44 ## Filtering 45 46 The filtering flag (`-f` or `--filter`) format is of "key=value". If there is more 47 than one filter, then pass multiple flags (e.g., `--filter "foo=bar" --filter "bif=baz"`) 48 49 The currently supported filters are: 50 51 * [name](#name) 52 * [id](#id) 53 * [label](#label) 54 * [desired-state](#desired-state) 55 56 #### name 57 58 The `name` filter matches on all or part of a task's name. 59 60 The following filter matches all tasks with a name containing the `redis` string. 61 62 $ docker node ps -f name=redis swarm-manager1 63 NAME IMAGE NODE DESIRED STATE CURRENT STATE 64 redis.1.7q92v0nr1hcgts2amcjyqg3pq redis:3.0.6 swarm-manager1 Running Running 5 hours 65 redis.6.b465edgho06e318egmgjbqo4o redis:3.0.6 swarm-manager1 Running Running 29 seconds 66 redis.7.bg8c07zzg87di2mufeq51a2qp redis:3.0.6 swarm-manager1 Running Running 5 seconds 67 redis.9.dkkual96p4bb3s6b10r7coxxt redis:3.0.6 swarm-manager1 Running Running 5 seconds 68 redis.10.0tgctg8h8cech4w0k0gwrmr23 redis:3.0.6 swarm-manager1 Running Running 5 seconds 69 70 71 #### id 72 73 The `id` filter matches a task's id. 74 75 $ docker node ps -f id=bg8c07zzg87di2mufeq51a2qp swarm-manager1 76 NAME IMAGE NODE DESIRED STATE CURRENT STATE 77 redis.7.bg8c07zzg87di2mufeq51a2qp redis:3.0.6 swarm-manager1 Running Running 5 seconds 78 79 80 #### label 81 82 The `label` filter matches tasks based on the presence of a `label` alone or a `label` and a 83 value. 84 85 The following filter matches tasks with the `usage` label regardless of its value. 86 87 ```bash 88 $ docker node ps -f "label=usage" 89 NAME IMAGE NODE DESIRED STATE CURRENT STATE 90 redis.6.b465edgho06e318egmgjbqo4o redis:3.0.6 swarm-manager1 Running Running 10 minutes 91 redis.7.bg8c07zzg87di2mufeq51a2qp redis:3.0.6 swarm-manager1 Running Running 9 minutes 92 ``` 93 94 95 #### desired-state 96 97 The `desired-state` filter can take the values `running`, `shutdown`, and `accepted`. 98 99 100 ## Related information 101 102 * [node demote](node_demote.md) 103 * [node inspect](node_inspect.md) 104 * [node ls](node_ls.md) 105 * [node promote](node_promote.md) 106 * [node rm](node_rm.md) 107 * [node update](node_update.md)