docker service ls

描述	列出服务
用法	`docker service ls [选项]`
别名	`docker service list`

Swarm 此命令适用于 Swarm 编排器。

描述

此命令列出在 Swarm 中运行的服务。

注意
这是一个集群管理命令，必须在 Swarm 管理器节点上执行。要了解管理器和工作器，请参阅文档中的Swarm 模式部分。

选项

选项	默认值	描述
`-f, --filter`		根据提供的条件筛选输出
`--format`		使用自定义模板格式化输出 'table': 以带列标题的表格格式打印输出（默认） 'table TEMPLATE': 使用给定的 Go 模板以表格格式打印输出 'json': 以 JSON 格式打印 'TEMPLATE': 使用给定的 Go 模板打印输出。有关使用模板格式化输出的更多信息，请参阅https://docs.container.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 以“0bcjw”开头的服务

$ docker service ls -f "id=0bcjw"
ID            NAME   MODE        REPLICAS  IMAGE
0bcjwfh8ychr  redis  replicated  1/1       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`	服务名称
`.模式`	服务模式（复制、全局）
`.副本`	服务副本
`.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"}