Docker 服务 ls

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

此命令适用于 Swarm 编排器。

描述

此命令列出了在 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

例子

在管理器节点上:

$ 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

该列显示 的实际任务数和期望任务数 服务。如果服务位于 或 中,它将 此外,将作业的完成状态显示为已完成任务 作业将执行的任务总数。REPLICASreplicated-jobglobal-job

筛选 (--filter)

筛选标志 ( 或 ) 格式为 “key=value”。如果还有更多 比一个过滤器,然后传递多个标志(例如 )。-f--filter--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

标签

该筛选条件根据是否存在单独或 a 和 a 值。labellabellabel

以下筛选条件匹配带有标签的所有服务,而不考虑 它的值: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

以下筛选条件仅匹配标签值为projectproject-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

模式

筛选器与服务的模式 (either 或 ) 匹配。modereplicatedglobal

以下筛选条件仅匹配服务。global

$ docker service ls --filter mode=global
ID                  NAME                MODE                REPLICAS            IMAGE
w7y0v2yrn620        top                 global              1/1                 busybox

名字

筛选条件匹配服务名称的所有或前缀。name

以下筛选条件匹配名称以 .redis

$ docker service ls --filter name=redis
ID            NAME   MODE        REPLICAS  IMAGE
0bcjwfh8ychr  redis  replicated  1/1       redis:7.4.1

设置输出格式 (--format)

格式选项 () pretty-prints 服务输出 使用 Go 模板。--format

下面列出了 Go 模板的有效占位符:

占 位 符描述
.ID服务 ID
.Name服务名称
.Mode服务模式(复制、全局)
.Replicas服务副本
.Image服务镜像
.Ports以 Ingress 模式发布的服务端口

使用该选项时,该命令将 完全按照模板声明的方式输出数据,或者在使用指令时,还包括列标题。--formatservice lstable

以下示例使用不带标头的模板,并输出所有服务的 、 和 以冒号 () 分隔的条目:IDModeReplicas:

$ 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"}