docker node ls

docker节点ls

描述

列出群中的节点

用法

docker node ls [OPTIONS]

选项

名字，简写	默认	描述
--filter, -f		根据提供的条件过滤输出
--format		使用Go模板的pretty-print节点
--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 Swarm经理知道的所有节点。您可以使用-f或--filter标志进行过滤。有关可用过滤器选项的更多信息，请参阅过滤部分。

实例

$ docker node ls

ID                           HOSTNAME        STATUS  AVAILABILITY  MANAGER STATUS
1bcef6utixb0l0ca7gxuivsj0    swarm-worker2   Ready   Active
38ciaotwjuritcdtn9npbnkuz    swarm-worker1   Ready   Active
e216jshn25ckzbvmwlnh5jr3g *  swarm-manager1  Ready   Active        Leader

注意：在上面的示例输出中，有一个隐藏列.Self，指示该节点是否与当前docker守护进程相同。一个*（例如，e216jshn25ckzbvmwlnh5jr3g *）表示该节点是当前的docker守护进程。

过滤

过滤标志（-f或--filter）格式为“key = value”。如果有多个过滤器，则传递多个标志（例如--filter "foo=bar" --filter "bif=baz"）

目前支持的过滤器是：

label

membership

name

role

ID

id过滤器匹配节点的ID的全部或部分。

$ docker node ls -f id=1

ID                         HOSTNAME       STATUS  AVAILABILITY  MANAGER STATUS
1bcef6utixb0l0ca7gxuivsj0  swarm-worker2  Ready   Active

label

label过滤器相匹配基于发动机标签和在存在节点label单独或label和值。节点标签当前不用于过滤。

foo无论其值如何，以下过滤器都会将标签与标签进行匹配。

$ docker node ls -f "label=foo"

ID                         HOSTNAME       STATUS  AVAILABILITY  MANAGER STATUS
1bcef6utixb0l0ca7gxuivsj0  swarm-worker2  Ready   Active

membership

membership过滤器相匹配的基础上一个存在的节点membership和一个值accepted或pending。

下面的过滤器相匹配的节点用membership的accepted。

$ docker node ls -f "membership=accepted"

ID                           HOSTNAME        STATUS  AVAILABILITY  MANAGER STATUS
1bcef6utixb0l0ca7gxuivsj0    swarm-worker2   Ready   Active
38ciaotwjuritcdtn9npbnkuz    swarm-worker1   Ready   Active

name

name过滤器上的全部或节点的主机名的一部分相匹配。

以下过滤器将名称等于swarm-master字符串的节点进行匹配。

$ docker node ls -f name=swarm-manager1

ID                           HOSTNAME        STATUS  AVAILABILITY  MANAGER STATUS
e216jshn25ckzbvmwlnh5jr3g *  swarm-manager1  Ready   Active        Leader

role

role过滤器相匹配的基础上一个存在的节点role和一个值worker或manager。

以下过滤器与具有manager角色的节点相匹配。

$ docker node ls -f "role=manager"

ID                           HOSTNAME        STATUS  AVAILABILITY  MANAGER STATUS
e216jshn25ckzbvmwlnh5jr3g *  swarm-manager1  Ready   Active        Leader

格式化

格式化选项（--format）使用Go模板打印节点输出。

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

占位符	描述
.ID	节点ID
.Self	守护进程的节点（true/false，true表示该节点与当前的docker守护进程相同）
.Hostname	节点主机名
.Status	节点状态
.Availability	节点可用性（ “active”, “pause”, or “drain”）
.ManagerStatus	节点的管理器状态
.TLSStatus	节点的TLS状态（“Ready”或“Needs Rotation”具有由旧CA签署的TLS证书）

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

下面的示例使用的模板没有报头，并输出ID，Hostname和TLS Status通过对所有节点冒号分隔的条目：