码头节点ps

描述

列出在一个或多个节点上运行的任务，默认为当前节点

API 1.24+  客户端和守护程序API都必须至少为 1.24， 才能使用此命令。docker version在客户端上使用命令检查客户端和守护程序API版本。

Swarm此命令与Swarm协调器一起使用。

用法

$ docker node ps [OPTIONS] [NODE...]

扩展说明

列出Docker知道的Node上的所有任务。您可以使用-f或--filter标志进行过滤 。有关可用过滤器选项的更多信息，请参阅过滤器部分。

笔记

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

有关此命令的示例用法，请参阅下面的示例部分。

选项

名称，简写 默认 描述
--filter ， -f 根据提供的条件过滤输出
--format 使用Go模板进行漂亮的打印任务
--no-resolve 不要将ID映射到名称
--no-trunc 不要截断输出
--quiet ， -q 仅显示任务ID

例子

$ 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）的格式为“键=值”。如果有多个过滤器，则传递多个标志（例如--filter "foo=bar" --filter "bif=baz"）

当前支持的过滤器是：

名称

该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和值。

以下过滤器将任务与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过滤器可以取值running，shutdown，或accepted。

格式设定

格式化选项（--format）使用Go模板漂亮地打印输出的任务。

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

占位符 描述
.ID 任务ID
.Name 任务名称
.Image 任务图片
.Node 节点编号
.DesiredState 任务的理想状态（running，shutdown，或accepted）
.CurrentState 任务的当前状态
.Error 错误
.Ports 任务发布的端口

当使用该--format选项时，该node ps命令将完全按照模板声明的方式输出数据，或者在使用 table指令时也包括列标题。

以下示例使用没有标题的模板，Name并为所有任务输出Image用冒号（:）分隔的 和条目：

$ docker node ps --format "{{.Name}}: {{.Image}}"
top.1: busybox
top.2: busybox
top.3: busybox

上级命令

命令 描述
码头工人节点 管理Swarm节点
命令 描述
码头节点降级 从群中的管理器降级一个或多个节点
码头节点检查 在一个或多个节点上显示详细信息
码头节点ls 列出群中的节点
docker节点提升 将一个或多个节点提升为集群中的管理器
码头节点ps 列出在一个或多个节点上运行的任务，默认为当前节点
码头节点rm 从群中删除一个或多个节点
码头节点更新 更新节点