FilesExpand file tree

 master

/

docker_node_ps.yaml

Copy path

Blame

More file actions

Blame

More file actions

Latest commit

 

History

History

History

127 lines (97 loc) · 4.57 KB

 master

/

docker_node_ps.yaml

Copy path

Top

File metadata and controls

• Code
• Blame

127 lines (97 loc) · 4.57 KB

Raw

Copy raw file

Download raw file

Open symbols panel

Edit and raw actions

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

74

75

76

77

78

79

80

81

82

83

84

85

86

87

88

89

90

91

92

93

94

95

96

97

98

99

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

command: docker node ps

short: List tasks running on one or more nodes, defaults to current node

long: 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.

usage: docker node ps [OPTIONS] [NODE...]

pname: docker node

plink: docker_node.yaml

options:

- option: filter

shorthand: f

description: Filter output based on conditions provided

- option: format

description: Pretty-print tasks using a Go template

- option: no-resolve

default_value: "false"

description: Do not map IDs to Names

- option: no-trunc

default_value: "false"

description: Do not truncate output

- option: quiet

shorthand: q

default_value: "false"

description: Only display task IDs

examples: |-

```bash

$ docker node ps swarm-manager1

NAME IMAGE NODE DESIRED STATE CURRENT STATE

redis.1.7q92v0nr1hcgts2amcjyqg3pq redis:3.0.6 swarm-manager1 Running Running 5 hours

redis.6.b465edgho06e318egmgjbqo4o redis:3.0.6 swarm-manager1 Running Running 29 seconds

redis.7.bg8c07zzg87di2mufeq51a2qp redis:3.0.6 swarm-manager1 Running Running 5 seconds

redis.9.dkkual96p4bb3s6b10r7coxxt redis:3.0.6 swarm-manager1 Running Running 5 seconds

redis.10.0tgctg8h8cech4w0k0gwrmr23 redis:3.0.6 swarm-manager1 Running Running 5 seconds

```

### Filtering

The filtering flag (`-f` or `--filter`) format is of "key=value". If there is more

than one filter, then pass multiple flags (e.g., `--filter "foo=bar" --filter "bif=baz"`)

The currently supported filters are:

* [name](#name)

* [id](#id)

* [label](#label)

* [desired-state](#desired-state)

#### name

The `name` filter matches on all or part of a task's name.

The following filter matches all tasks with a name containing the `redis` string.

```bash

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

NAME IMAGE NODE DESIRED STATE CURRENT STATE

redis.1.7q92v0nr1hcgts2amcjyqg3pq redis:3.0.6 swarm-manager1 Running Running 5 hours

redis.6.b465edgho06e318egmgjbqo4o redis:3.0.6 swarm-manager1 Running Running 29 seconds

redis.7.bg8c07zzg87di2mufeq51a2qp redis:3.0.6 swarm-manager1 Running Running 5 seconds

redis.9.dkkual96p4bb3s6b10r7coxxt redis:3.0.6 swarm-manager1 Running Running 5 seconds

redis.10.0tgctg8h8cech4w0k0gwrmr23 redis:3.0.6 swarm-manager1 Running Running 5 seconds

```

#### id

The `id` filter matches a task's id.

```bash

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

NAME IMAGE NODE DESIRED STATE CURRENT STATE

redis.7.bg8c07zzg87di2mufeq51a2qp redis:3.0.6 swarm-manager1 Running Running 5 seconds

```

#### label

The `label` filter matches tasks based on the presence of a `label` alone or a `label` and a

value.

The following filter matches tasks with the `usage` label regardless of its value.

```bash

$ docker node ps -f "label=usage"

NAME IMAGE NODE DESIRED STATE CURRENT STATE

redis.6.b465edgho06e318egmgjbqo4o redis:3.0.6 swarm-manager1 Running Running 10 minutes

redis.7.bg8c07zzg87di2mufeq51a2qp redis:3.0.6 swarm-manager1 Running Running 9 minutes

```

#### desired-state

The `desired-state` filter can take the values `running`, `shutdown`, or `accepted`.

### Formatting

The formatting options (`--format`) pretty-prints tasks output

using a Go template.

Valid placeholders for the Go template are listed below:

Placeholder | Description

----------------|------------------------------------------------------------------------------------------

`.Name` | Task name

`.Image` | Task image

`.Node` | Node ID

`.DesiredState` | Desired state of the task (`running`, `shutdown`, or `accepted`)

`.CurrentState` | Current state of the task

`.Error` | Error

`.Ports` | Task published ports

When using the `--format` option, the `node ps` command will either

output the data exactly as the template declares or, when using the

`table` directive, includes column headers as well.

The following example uses a template without headers and outputs the

`Name` and `Image` entries separated by a colon for all tasks:

```bash

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

top.1: busybox

top.2: busybox

top.3: busybox

```