docker node ls

描述

列出群中的节点

用法

docker node ls [OPTIONS]

选项

父命令

相关命令

扩展描述

列出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"）

目前支持的过滤器是：

• ID

• 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模板的有效占位符列在下面：

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

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