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
或--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
) pretty-prints 服务输出
使用 Go 模板。
下面列出了 Go 模板的有效占位符:
占 位 符 | 描述 |
---|---|
.ID | 服务 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"}