github.com/kim0/docker@v0.6.2-0.20161130212042-4addda3f07e7/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 -a, --all Display all instances 26 -f, --filter value Filter output based on conditions provided 27 --help Print usage 28 --no-resolve Do not map IDs to Names 29 --no-trunc Do not truncate output 30 ``` 31 32 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. 33 34 Example output: 35 36 $ docker node ps swarm-manager1 37 NAME IMAGE NODE DESIRED STATE CURRENT STATE 38 redis.1.7q92v0nr1hcgts2amcjyqg3pq redis:3.0.6 swarm-manager1 Running Running 5 hours 39 redis.6.b465edgho06e318egmgjbqo4o redis:3.0.6 swarm-manager1 Running Running 29 seconds 40 redis.7.bg8c07zzg87di2mufeq51a2qp redis:3.0.6 swarm-manager1 Running Running 5 seconds 41 redis.9.dkkual96p4bb3s6b10r7coxxt redis:3.0.6 swarm-manager1 Running Running 5 seconds 42 redis.10.0tgctg8h8cech4w0k0gwrmr23 redis:3.0.6 swarm-manager1 Running Running 5 seconds 43 44 45 ## Filtering 46 47 The filtering flag (`-f` or `--filter`) format is of "key=value". If there is more 48 than one filter, then pass multiple flags (e.g., `--filter "foo=bar" --filter "bif=baz"`) 49 50 The currently supported filters are: 51 52 * [name](#name) 53 * [id](#id) 54 * [label](#label) 55 * [desired-state](#desired-state) 56 57 #### name 58 59 The `name` filter matches on all or part of a task's name. 60 61 The following filter matches all tasks with a name containing the `redis` string. 62 63 $ docker node ps -f name=redis swarm-manager1 64 NAME IMAGE NODE DESIRED STATE CURRENT STATE 65 redis.1.7q92v0nr1hcgts2amcjyqg3pq redis:3.0.6 swarm-manager1 Running Running 5 hours 66 redis.6.b465edgho06e318egmgjbqo4o redis:3.0.6 swarm-manager1 Running Running 29 seconds 67 redis.7.bg8c07zzg87di2mufeq51a2qp redis:3.0.6 swarm-manager1 Running Running 5 seconds 68 redis.9.dkkual96p4bb3s6b10r7coxxt redis:3.0.6 swarm-manager1 Running Running 5 seconds 69 redis.10.0tgctg8h8cech4w0k0gwrmr23 redis:3.0.6 swarm-manager1 Running Running 5 seconds 70 71 72 #### id 73 74 The `id` filter matches a task's id. 75 76 $ docker node ps -f id=bg8c07zzg87di2mufeq51a2qp swarm-manager1 77 NAME IMAGE NODE DESIRED STATE CURRENT STATE 78 redis.7.bg8c07zzg87di2mufeq51a2qp redis:3.0.6 swarm-manager1 Running Running 5 seconds 79 80 81 #### label 82 83 The `label` filter matches tasks based on the presence of a `label` alone or a `label` and a 84 value. 85 86 The following filter matches tasks with the `usage` label regardless of its value. 87 88 ```bash 89 $ docker node ps -f "label=usage" 90 NAME IMAGE NODE DESIRED STATE CURRENT STATE 91 redis.6.b465edgho06e318egmgjbqo4o redis:3.0.6 swarm-manager1 Running Running 10 minutes 92 redis.7.bg8c07zzg87di2mufeq51a2qp redis:3.0.6 swarm-manager1 Running Running 9 minutes 93 ``` 94 95 96 #### desired-state 97 98 The `desired-state` filter can take the values `running`, `shutdown`, and `accepted`. 99 100 101 ## Related information 102 103 * [node inspect](node_inspect.md) 104 * [node update](node_update.md) 105 * [node ls](node_ls.md) 106 * [node rm](node_rm.md)