Docker 堆栈服务

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

此命令适用于 Swarm 编排器。

描述

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

注意

这是一个集群管理命令,必须在 swarm 上执行 Manager 节点。要了解 Manager 和 worker,请参阅 文档。

选项

选择违约描述
-f, --filter根据提供的条件筛选输出
--format使用自定义模板格式化输出:
'table':以带有列标题的表格格式打印输出(默认)
'table TEMPLATE':使用给定的 Go 模板
以表格格式打印输出'json':以 JSON 格式
打印'TEMPLATE':使用给定的 Go 模板打印输出。
有关使用模板设置输出格式的更多信息,请参阅 https://docs.docker.com/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--filterkey=value--filter "foo=bar" --filter "bif=baz"OR

以下命令同时显示 和 服务:webdb

$ 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)
  • mode (或--filter mode=replicated--filter mode=global)
    • Swarm:不支持
  • 名称 (--filter name=myapp_web)
  • 节点 (--filter node=mynode)
    • Swarm:不支持
  • 服务 (--filter service=web)
    • Swarm:不支持

设置输出格式 (--format)

格式选项 () pretty-prints 服务输出 使用 Go 模板。--format

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

占 位 符描述
.ID服务 ID
.Name服务名称
.Mode服务模式(复制、全局)
.Replicas服务副本
.Image服务镜像

使用该选项时,该命令将 完全按照模板声明的方式输出数据,或者在使用指令时,还包括列标题。--formatstack servicestable

以下示例使用不带标头的模板,并输出所有服务的 、 和 以冒号 () 分隔的条目:IDModeReplicas:

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