Add format to docker stack ls

Signed-off-by: Boaz Shuster <ripcurld.github@gmail.com>
This commit is contained in:
Boaz Shuster 2017-03-05 20:02:03 +02:00 committed by Tibor Vass
parent 33fecab492
commit 5be9e57c51
1 changed files with 26 additions and 1 deletions

View File

@ -24,7 +24,8 @@ Aliases:
ls, list
Options:
--help Print usage
--help Print usage
--format string Pretty-print stacks using a Go template
```
## Description
@ -43,6 +44,30 @@ vossibility-stack 6
myapp 2
```
### Formatting
The formatting option (`--format`) pretty-prints stacks using a Go template.
Valid placeholders for the Go template are listed below:
| Placeholder | Description |
| ----------- | ------------------ |
| `.Name` | Stack name |
| `.Services` | Number of services |
When using the `--format` option, the `stack ls` command either outputs
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 `Services` entries separated by a colon for all stacks:
```bash
$ docker stack ls --format "{{.Name}}: {{.Services}}"
web-server: 1
web-cache: 4
```
## Related commands
* [stack deploy](stack_deploy.md)