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
) - 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 | 服务镜像 |
使用该选项时,该命令将
完全按照模板声明的方式输出数据,或者在使用指令时,还包括列标题。--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"}