mirror of
https://github.com/docker/cli.git
synced 2025-08-29 00:47:54 +03:00
f30bde6adb
these markdown files are not consumed directly in the docs, but only their content is included through the YAML does, so there's no need to have these comments in them Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
118 lines
3.9 KiB
Markdown
118 lines
3.9 KiB
Markdown
---
|
|
title: "stack services"
|
|
description: "The stack services command description and usage"
|
|
keywords: "stack, services"
|
|
---
|
|
|
|
# stack services
|
|
|
|
```markdown
|
|
Usage: docker stack services [OPTIONS] STACK
|
|
|
|
List the services in the stack
|
|
|
|
Options:
|
|
-f, --filter filter Filter output based on conditions provided
|
|
--format string Pretty-print services using a Go template
|
|
--help Print usage
|
|
--kubeconfig string Kubernetes config file
|
|
--namespace string Kubernetes namespace to use
|
|
--orchestrator string Orchestrator to use (swarm|kubernetes|all)
|
|
-q, --quiet Only display IDs
|
|
```
|
|
|
|
## Description
|
|
|
|
Lists the services that are running as part of the specified stack.
|
|
|
|
> **Note**: This is a cluster management command. When using swarm as an orchestrator,
|
|
> this command must be executed on a swarm manager node. To learn about managers
|
|
> and workers, refer to the [Swarm mode section](https://docs.docker.com/engine/swarm/)
|
|
> in the documentation.
|
|
|
|
## Examples
|
|
|
|
The following command shows all services in the `myapp` stack:
|
|
|
|
```bash
|
|
$ docker stack services myapp
|
|
|
|
ID NAME REPLICAS IMAGE COMMAND
|
|
7be5ei6sqeye myapp_web 1/1 nginx@sha256:23f809e7fd5952e7d5be065b4d3643fbbceccd349d537b62a123ef2201bc886f
|
|
dn7m7nhhfb9y myapp_db 1/1 mysql@sha256:a9a5b559f8821fe73d58c3606c812d1c044868d42c63817fa5125fd9d8b7b539
|
|
```
|
|
|
|
### Filtering
|
|
|
|
The filtering flag (`-f` or `--filter`) format is a `key=value` pair. If there
|
|
is more than one filter, then pass multiple flags (e.g. `--filter "foo=bar" --filter "bif=baz"`).
|
|
Multiple filter flags are combined as an `OR` filter.
|
|
|
|
The following command shows both the `web` and `db` services:
|
|
|
|
```bash
|
|
$ docker stack services --filter name=myapp_web --filter name=myapp_db myapp
|
|
|
|
ID NAME REPLICAS IMAGE COMMAND
|
|
7be5ei6sqeye myapp_web 1/1 nginx@sha256:23f809e7fd5952e7d5be065b4d3643fbbceccd349d537b62a123ef2201bc886f
|
|
dn7m7nhhfb9y myapp_db 1/1 mysql@sha256:a9a5b559f8821fe73d58c3606c812d1c044868d42c63817fa5125fd9d8b7b539
|
|
```
|
|
|
|
The currently supported filters are:
|
|
|
|
* id / ID (`--filter id=7be5ei6sqeye`, or `--filter ID=7be5ei6sqeye`)
|
|
* Swarm: supported
|
|
* Kubernetes: not supported
|
|
* label (`--filter label=key=value`)
|
|
* Swarm: supported
|
|
* Kubernetes: supported
|
|
* mode (`--filter mode=replicated`, or `--filter mode=global`)
|
|
* Swarm: not supported
|
|
* Kubernetes: supported
|
|
* name (`--filter name=myapp_web`)
|
|
* Swarm: supported
|
|
* Kubernetes: supported
|
|
* node (`--filter node=mynode`)
|
|
* Swarm: not supported
|
|
* Kubernetes: supported
|
|
* service (`--filter service=web`)
|
|
* Swarm: not supported
|
|
* Kubernetes: supported
|
|
|
|
### Formatting
|
|
|
|
The formatting options (`--format`) pretty-prints services output
|
|
using a Go template.
|
|
|
|
Valid placeholders for the Go template are listed below:
|
|
|
|
Placeholder | Description
|
|
------------|------------------------------------------------------------------------------------------
|
|
`.ID` | Service ID
|
|
`.Name` | Service name
|
|
`.Mode` | Service mode (replicated, global)
|
|
`.Replicas` | Service replicas
|
|
`.Image` | Service image
|
|
|
|
When using the `--format` option, the `stack services` 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
|
|
`ID`, `Mode`, and `Replicas` entries separated by a colon for all services:
|
|
|
|
```bash
|
|
$ docker stack services --format "{{.ID}}: {{.Mode}} {{.Replicas}}"
|
|
|
|
0zmvwuiu3vue: replicated 10/10
|
|
fm6uf97exkul: global 5/5
|
|
```
|
|
|
|
|
|
## Related commands
|
|
|
|
* [stack deploy](stack_deploy.md)
|
|
* [stack ls](stack_ls.md)
|
|
* [stack ps](stack_ps.md)
|
|
* [stack rm](stack_rm.md)
|