List stacks
API 1.25+ The client and daemon API must both be at least 1.25 to use this command. Use the docker version command on the client to check your client and daemon API versions.
docker stack ls [OPTIONS]
| Name, shorthand | Default | Description |
--all-namespaces |
Kubernetes List stacks from all Kubernetes namespaces | |
--format | Pretty-print stacks using a Go template | |
--namespace |
Kubernetes Kubernetes namespaces to use | |
--kubeconfig |
Kubernetes Kubernetes config file | |
--orchestrator | Orchestrator to use (swarm|kubernetes|all) |
| Command | Description |
|---|---|
| docker stack | Manage Docker stacks |
| Command | Description |
| docker stack deploy | Deploy a new stack or update an existing stack |
| docker stack ls | List stacks |
| docker stack ps | List the tasks in the stack |
| docker stack rm | Remove one or more stacks |
| docker stack services | List the services in the stack |
Lists the stacks.
The following command shows all stacks and some additional information:
$ docker stack ls
ID SERVICES ORCHESTRATOR
myapp 2 Kubernetes
vossibility-stack 6 Swarm
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 |
.Orchestrator | Orchestrator name |
.Namespace | Namespace |
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:
$ docker stack ls --format "{{.Name}}: {{.Services}}"
web-server: 1
web-cache: 4
© 2019 Docker, Inc.
Licensed under the Apache License, Version 2.0.
Docker and the Docker logo are trademarks or registered trademarks of Docker, Inc. in the United States and/or other countries.
Docker, Inc. and other parties may also have trademark rights in other terms used herein.
https://docs.docker.com/engine/reference/commandline/stack_ls/