Docker 17参考手册
引擎: CLI | Engine: CLI
docker node ps
描述
列出在一个或多个节点上运行的任务,默认为当前节点
用法
docker node ps [OPTIONS] [NODE...]
选项
名字,简写 |
默认 |
描述 |
---|---|---|
--filter, -f |
|
根据提供的条件过滤输出 |
--format |
|
使用Go模板的打印任务 |
--no-resolve |
false |
不要将ID映射到名称 |
--no-trunc |
false |
不要截断输出 |
--quiet, -q |
false |
只显示任务ID |
父命令
命令 |
描述 |
---|---|
docker节点 |
管理Swarm节点 |
相关命令
命令 |
描述 |
---|---|
docker node demote |
从群中的经理中降级一个或多个节点 |
docker node inspect |
在一个或多个节点上显示详细信息 |
docker node ls |
列出群中的节点 |
docker node promote |
将一个或多个节点提升为群中的经理 |
docker node ps |
列出在一个或多个节点上运行的任务,默认为当前节点 |
docker node rm |
从群中删除一个或多个节点 |
docker node update |
更新节点 |
扩展描述
列出Docker知道的节点上的所有任务。您可以使用-f
或--filter
标志进行过滤。有关可用过滤器选项的更多信息,请参阅过滤部分。
实例
$ docker node ps swarm-manager1
NAME IMAGE NODE DESIRED STATE CURRENT STATE
redis.1.7q92v0nr1hcgts2amcjyqg3pq redis:3.0.6 swarm-manager1 Running Running 5 hours
redis.6.b465edgho06e318egmgjbqo4o redis:3.0.6 swarm-manager1 Running Running 29 seconds
redis.7.bg8c07zzg87di2mufeq51a2qp redis:3.0.6 swarm-manager1 Running Running 5 seconds
redis.9.dkkual96p4bb3s6b10r7coxxt redis:3.0.6 swarm-manager1 Running Running 5 seconds
redis.10.0tgctg8h8cech4w0k0gwrmr23 redis:3.0.6 swarm-manager1 Running Running 5 seconds
过滤
过滤标志(-f
或--filter
)格式为“key = value”。如果有多个过滤器,则传递多个标志(例如--filter "foo=bar" --filter "bif=baz"
)
目前支持的过滤器是:
- name
- id
- label
- desired-state
name
name
过滤器上的任务名称的全部或部分匹配。
以下过滤器将使用包含该redis
字符串的名称匹配所有任务。
$ docker node ps -f name=redis swarm-manager1
NAME IMAGE NODE DESIRED STATE CURRENT STATE
redis.1.7q92v0nr1hcgts2amcjyqg3pq redis:3.0.6 swarm-manager1 Running Running 5 hours
redis.6.b465edgho06e318egmgjbqo4o redis:3.0.6 swarm-manager1 Running Running 29 seconds
redis.7.bg8c07zzg87di2mufeq51a2qp redis:3.0.6 swarm-manager1 Running Running 5 seconds
redis.9.dkkual96p4bb3s6b10r7coxxt redis:3.0.6 swarm-manager1 Running Running 5 seconds
redis.10.0tgctg8h8cech4w0k0gwrmr23 redis:3.0.6 swarm-manager1 Running Running 5 seconds
id
id
过滤器匹配任务的ID。
$ docker node ps -f id=bg8c07zzg87di2mufeq51a2qp swarm-manager1
NAME IMAGE NODE DESIRED STATE CURRENT STATE
redis.7.bg8c07zzg87di2mufeq51a2qp redis:3.0.6 swarm-manager1 Running Running 5 seconds
label
label
过滤器匹配基础上的存在的任务label
单独或label
和值。
usage
不管其值如何,以下过滤器都会将任务与标签进行匹配。
$ docker node ps -f "label=usage"
NAME IMAGE NODE DESIRED STATE CURRENT STATE
redis.6.b465edgho06e318egmgjbqo4o redis:3.0.6 swarm-manager1 Running Running 10 minutes
redis.7.bg8c07zzg87di2mufeq51a2qp redis:3.0.6 swarm-manager1 Running Running 9 minutes
desired-state
desired-state
过滤器可以取值running
,shutdown
,或accepted
。
Formatting
格式化选项(--format
)可以很好地打印使用Go模板输出的任务。
下面列出了Go模板的有效占位符:
占位符 |
描述 |
---|---|
.Name |
任务名称 |
.Image |
任务图像 |
.Node |
节点ID |
.DesiredState |
任务的期望状态(运行,关闭或接受) |
.CurrentState |
任务的当前状态 |
.Error |
错误 |
.Ports |
任务发布的端口 |
当使用--format
选项时,node ps
命令将完全按照模板声明输出数据,或者在使用该table
指令时也包含列标题。
下面的示例使用没有标头的模板,并输出Name
和Image
用冒号分隔的项用于所有任务:
$ docker node ps --format "{{.Name}}: {{.Image}}"
top.1: busybox
top.2: busybox
top.3: busybox
引擎: CLI | Engine: CLI相关

Docker 是一个开源的应用容器引擎,让开发者可以打包他们的应用以及依赖包到一个可移植的容器中,然后发布到任何流行的 Linux 机器上,也可以实现虚拟化。容器是完全使用沙箱机制,相互之间不会有任何接口。
主页 | https://docker.com/ |
源码 | https://github.com/docker/docker |
版本 | 17 |
发布版本 | 17.06 |