docker service ls
描述 | 列出服务 |
---|---|
用法 | docker service ls [OPTIONS] |
别名 | docker service list |
Swarm 此命令适用于 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 |
示例
在管理节点上
$ docker service ls
ID NAME MODE REPLICAS IMAGE
c8wgl7q4ndfd frontend replicated 5/5 nginx:alpine
dmu1ept4cxcf redis replicated 3/3 redis:7.4.1
iwe3278osahj mongo global 7/7 mongo:3.3
hh08h9uu8uwr job replicated-job 1/1 (3/5 completed) nginx:latest
REPLICAS
列显示服务的实际和期望任务数。如果服务处于 replicated-job
或 global-job
模式,它还会额外显示作业的完成状态,即已完成任务数与作业将执行的总任务数之比。
过滤 (--filter)
过滤标志(-f
或 --filter
)的格式为 “key=value”。如果存在多个过滤器,则传递多个标志(例如,--filter "foo=bar" --filter "bif=baz"
)。
当前支持的过滤器有
id
id
过滤器匹配服务的全部 ID 或 ID 的前缀。
以下过滤器匹配 ID 以 0bcjw
开头的服务
$ docker service ls -f "id=0bcjw"
ID NAME MODE REPLICAS IMAGE
0bcjwfh8ychr redis replicated 1/1 redis:7.4.1
label
label
过滤器基于是否存在 label
或 label
和其值来匹配服务。
以下过滤器匹配所有带有 project
标签的服务,无论其值如何
$ docker service ls --filter label=project
ID NAME MODE REPLICAS IMAGE
01sl1rp6nj5u frontend2 replicated 1/1 nginx:alpine
36xvvwwauej0 frontend replicated 5/5 nginx:alpine
74nzcxxjv6fq backend replicated 3/3 redis:7.4.1
以下过滤器仅匹配带有 project
标签且值为 project-a
的服务。
$ docker service ls --filter label=project=project-a
ID NAME MODE REPLICAS IMAGE
36xvvwwauej0 frontend replicated 5/5 nginx:alpine
74nzcxxjv6fq backend replicated 3/3 redis:7.4.1
mode
mode
过滤器匹配服务的模式(replicated
或 global
)。
以下过滤器仅匹配 global
服务。
$ docker service ls --filter mode=global
ID NAME MODE REPLICAS IMAGE
w7y0v2yrn620 top global 1/1 busybox
name
name
过滤器匹配服务的全部名称或名称的前缀。
以下过滤器匹配名称以 redis
开头的服务。
$ docker service ls --filter name=redis
ID NAME MODE REPLICAS IMAGE
0bcjwfh8ychr redis replicated 1/1 redis:7.4.1
格式化输出 (--format)
格式化选项(--format
)使用 Go 模板美观地打印服务输出。
以下列出了 Go 模板的有效占位符
占位符 | 描述 |
---|---|
.ID | 服务 ID |
.Name | 服务名称 |
.Mode | 服务模式 (replicated, global) |
.Replicas | 服务副本数 |
.Image | 服务镜像 |
.Ports | 服务端口(ingress 模式下发布) |
使用 --format
选项时,service ls
命令会按照模板声明精确输出数据,或者在使用 table
指令时,同时包含列头。
以下示例使用不带头部的模板,并输出所有服务的 ID
、Mode
和 Replicas
条目,它们之间用冒号(:
)分隔
$ docker service ls --format "{{.ID}}: {{.Mode}} {{.Replicas}}"
0zmvwuiu3vue: replicated 10/10
fm6uf97exkul: global 5/5
要以 JSON 格式列出所有服务,请使用 json
指令
$ docker service ls --format json
{"ID":"ssniordqolsi","Image":"hello-world:latest","Mode":"replicated","Name":"hello","Ports":"","Replicas":"0/1"}