docker stack services

描述列出栈中的服务
用法docker stack services [OPTIONS] STACK

Swarm 此命令适用于 Swarm 编排器。

描述

列出作为指定栈一部分运行的服务。

注意

这是一个集群管理命令，必须在 Swarm 管理节点上执行。要了解管理程序和工作程序，请参阅文档中的Swarm 模式部分。

选项

选项默认值描述
-f, --filter根据提供的条件过滤输出
--format使用自定义模板格式化输出
'table': 以表格格式打印输出，包含列标题（默认）
'table TEMPLATE': 使用给定的 Go 模板以表格格式打印输出
'json': 以 JSON 格式打印
'TEMPLATE': 使用给定的 Go 模板打印输出。
有关使用模板格式化输出的更多信息，请参阅https://docs.docker.net.cn/go/formatting/。
-q, --quiet仅显示 ID

示例

以下命令显示myapp栈中的所有服务

$ 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

过滤 (--filter)

过滤标志 (-f 或 --filter) 格式为key=value对。如果有多个过滤器，则传递多个标志（例如--filter "foo=bar" --filter "bif=baz"）。多个过滤器标志组合为OR过滤器。

以下命令显示web和db服务。

$ 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

当前支持的过滤器是

  • id / ID (--filter id=7be5ei6sqeye，或--filter ID=7be5ei6sqeye)
  • label (--filter label=key=value)
  • mode (--filter mode=replicated，或--filter mode=global)
    • Swarm：不支持
  • name (--filter name=myapp_web)
  • node (--filter node=mynode)
    • Swarm：不支持
  • service (--filter service=web)
    • Swarm：不支持

格式化输出 (--format)

格式化选项 (--format) 使用 Go 模板对服务输出进行漂亮打印。

Go 模板的有效占位符列在下面

占位符描述
.ID服务 ID
.Name服务名称
.Mode服务模式 (replicated, global)
.Replicas服务副本
.Image服务镜像

使用--format选项时，stack services命令将完全按照模板声明的输出数据，或者当使用table指令时，也包含列标题。

以下示例使用不带标题的模板，并为所有服务输出以冒号 (:) 分隔的ID、Mode和Replicas条目

$ docker stack services --format "{{.ID}}: {{.Mode}} {{.Replicas}}"

0zmvwuiu3vue: replicated 10/10
fm6uf97exkul: global 5/5

要以 JSON 格式列出所有服务，请使用json指令

$ docker stack services ls --format json
{"ID":"0axqbl293vwm","Image":"localstack/localstack:latest","Mode":"replicated","Name":"myapp_localstack","Ports":"*:4566-\u003e4566/tcp, *:8080-\u003e8080/tcp","Replicas":"0/1"}
{"ID":"384xvtzigz3p","Image":"redis:6.0.9-alpine3.12","Mode":"replicated","Name":"myapp_redis","Ports":"*:6379-\u003e6379/tcp","Replicas":"1/1"}
{"ID":"hyujct8cnjkk","Image":"postgres:13.2-alpine","Mode":"replicated","Name":"myapp_repos-db","Ports":"*:5432-\u003e5432/tcp","Replicas":"0/1"}