docker 服务 ls

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

Swarm 此命令与 Swarm 协调器配合使用。

描述

此命令列出了集群中正在运行的服务。

笔记

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

选项

选项默认描述
-f, --filter根据提供的条件过滤输出
--format使用自定义模板设置输出格式：
'table'：以带有列标题的表格格式打印输出（默认）
'table TEMPLATE'：使用给定的 Go 模板以表格格式打印输出
'json'：以 JSON 格式打印
'TEMPLATE'：打印使用给定的 Go 模板输出。有关使用模板格式化输出的更多信息，
请参阅 https://docker.github.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的存在来匹配服务。labellabel

以下过滤器匹配带有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标签和 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:3.0.6

模式

过滤器匹配服务的mode模式（ 或replicated） 。global

以下过滤器仅匹配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:3.0.6

格式化输出（--format）

格式化选项 ( --format) 使用 Go 模板漂亮地打印服务输出。

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

占位符描述
.ID服务编号
.Name服务名称
.Mode服务模式（复制、全局）
.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"}