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.container.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`)
标签 (`--filter label=key=value`)
模式 (`--filter mode=replicated`，或 `--filter mode=global`)
- Swarm：不支持
名称 (`--filter name=myapp_web`)
节点 (`--filter node=mynode`)
- Swarm：不支持
服务 (`--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"}