码头栈服务

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

Swarm 此命令与 Swarm 协调器配合使用。

描述

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

笔记

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

选项

选项默认描述
-f, --filter根据提供的条件过滤输出
--format使用自定义模板设置输出格式：
'table'：以带有列标题的表格格式打印输出（默认）
'table TEMPLATE'：使用给定的 Go 模板以表格格式打印输出
'json'：以 JSON 格式打印
'TEMPLATE'：打印使用给定的 Go 模板输出。有关使用模板格式化输出的更多信息，
请参阅 https://docker.github.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)
    • 集群：不支持
  • 姓名 （--filter name=myapp_web）
  • 节点 ( --filter node=mynode)
    • 集群：不支持
  • 服务 （--filter service=web）
    • 集群：不支持

格式化输出（--format）

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

下面列出了 Go 模板的有效占位符：

占位符描述
.ID服务编号
.Name服务名称
.Mode服务模式（复制、全局）
.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"}