docker node 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 node update | 更新节点 |
扩展描述
列出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 Activelabel
label过滤器相匹配基于发动机标签和在存在节点label单独或label和值。节点标签当前不用于过滤。
foo无论其值如何，以下过滤器都会将标签与标签进行匹配。
$ docker node ls -f "label=foo"
ID HOSTNAME STATUS AVAILABILITY MANAGER STATUS
1bcef6utixb0l0ca7gxuivsj0 swarm-worker2 Ready Activemembership
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 Activename
name过滤器上的全部或节点的主机名的一部分相匹配。
以下过滤器将名称等于swarm-master字符串的节点进行匹配。
$ docker node ls -f name=swarm-manager1
ID HOSTNAME STATUS AVAILABILITY MANAGER STATUS
e216jshn25ckzbvmwlnh5jr3g * swarm-manager1 Ready Active Leaderrole
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通过对所有节点冒号分隔的条目：
本文档系腾讯云开发者社区成员共同维护，如有问题请联系 cloudcommunity@tencent.com
