docker stack services

描述列出堆栈中的服务
用法docker stack services [选项] 堆栈

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"}