DockerCLI/docs/reference/commandline/stack_ps.md

1.6 KiB

title description keywords
stack ps The stack ps command description and usage stack, ps

stack ps

Usage:  docker stack ps [OPTIONS] STACK

List the tasks in the stack

Options:
  -f, --filter filter   Filter output based on conditions provided
      --format string   Pretty-print tasks using a Go template
      --help            Print usage
      --no-resolve      Do not map IDs to Names
      --no-trunc        Do not truncate output
  -q, --quiet           Only display task IDs

Description

Lists the tasks that are running as part of the specified stack. This command has to be run targeting a manager node.

Examples

$ docker stack ps

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. For example, -f name=redis.1 -f name=redis.7 returns both redis.1 and redis.7 tasks.

The currently supported filters are:

  • id
  • name
  • desired-state