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:3.0.6
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 以 0bcjw 开头的服务：

$ docker service ls -f "id=0bcjw"
ID            NAME   MODE        REPLICAS  IMAGE
0bcjwfh8ychr  redis  replicated  1/1       redis:3.0.6

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:3.0.6

以下过滤器只匹配具有值为 project-a 的 project 标签的服务：

$ 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:3.0.6

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:3.0.6

格式化输出 (--format)

格式化选项 (--format) 使用 Go 模板对服务输出进行美化打印。

Go 模板的有效占位符如下所示：

占位符描述
.ID服务 ID
.Name服务名称
.Mode服务模式 (replicated, global)
.Replicas服务副本
.Image服务镜像
.Ports以入口模式发布的服务端口

使用 --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"}