docker node ls
| 描述 | 列出集群中的节点 |
|---|---|
| 用法 | docker node ls [OPTIONS] |
| 别名 | docker node list |
Swarm 此命令适用于 Swarm 编排器。
描述
列出 Docker Swarm 管理器已知的全部节点。可以使用-f或--filter标志进行筛选。有关可用筛选选项的更多信息，请参阅筛选部分。
注意
这是一个集群管理命令，必须在 Swarm 管理器节点上执行。要了解管理器和工作节点，请参阅文档中的Swarm 模式部分。
选项
| 选项 | 默认值 | 描述 |
|---|---|---|
-f, --filter | 根据提供的条件筛选输出 | |
--format | 使用自定义模板格式化输出 'table': 以包含列标题的表格格式打印输出（默认） 'table TEMPLATE': 使用给定的 Go 模板以表格格式打印输出 'json': 以 JSON 格式打印 'TEMPLATE': 使用给定的 Go 模板打印输出。 有关使用模板格式化输出的更多信息，请参阅https://docs.dockerd.com.cn/go/formatting/。 | |
-q, --quiet | 仅显示 ID |
示例
$ 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 守护程序。
筛选（--filter）
筛选标志（-f或--filter）格式为“键=值”。如果有多个筛选器，则传递多个标志（例如，--filter "foo=bar" --filter "bif=baz"）
当前支持的筛选器为：
id
id筛选器匹配节点 ID 的全部或部分内容。
$ docker node ls -f id=1
ID HOSTNAME STATUS AVAILABILITY MANAGER STATUS
1bcef6utixb0l0ca7gxuivsj0 swarm-worker2 Ready Active
label
label筛选器根据引擎标签以及仅label的存在或label和值的存在来匹配节点。引擎标签在守护程序配置中配置。要筛选 Swarm node标签，请使用node.label。
以下筛选器匹配具有foo标签的节点，无论其值如何。
$ docker node ls -f "label=foo"
ID HOSTNAME STATUS AVAILABILITY MANAGER STATUS
1bcef6utixb0l0ca7gxuivsj0 swarm-worker2 Ready Active
node.label
node.label筛选器根据节点标签以及仅node.label的存在或node.label和值的存在来匹配节点。
以下筛选器将节点更新为具有region节点标签
$ docker node update --label-add region=region-a swarm-test-01
$ docker node update --label-add region=region-a swarm-test-02
$ docker node update --label-add region=region-b swarm-test-03
$ docker node update --label-add region=region-b swarm-test-04
显示所有设置了region节点标签的节点
$ docker node ls --filter node.label=region
ID HOSTNAME STATUS AVAILABILITY MANAGER STATUS ENGINE VERSION
yg550ettvsjn6g6t840iaiwgb * swarm-test-01 Ready Active Leader 23.0.3
2lm9w9kbepgvkzkkeyku40e65 swarm-test-02 Ready Active Reachable 23.0.3
hc0pu7ntc7s4uvj4pv7z7pz15 swarm-test-03 Ready Active Reachable 23.0.3
n41b2cijmhifxxvz56vwrs12q swarm-test-04 Ready Active 23.0.3
显示所有具有region节点标签且值为region-a的节点
$ docker node ls --filter node.label=region=region-a
ID HOSTNAME STATUS AVAILABILITY MANAGER STATUS ENGINE VERSION
yg550ettvsjn6g6t840iaiwgb * swarm-test-01 Ready Active Leader 23.0.3
2lm9w9kbepgvkzkkeyku40e65 swarm-test-02 Ready Active Reachable 23.0.3
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）
格式化选项（--format）使用 Go 模板漂亮打印节点输出。
Go 模板的有效占位符如下所示：
| 占位符 | 描述 |
|---|---|
.ID | 节点 ID |
.Self | 守护程序的节点（true/false，true表示该节点与当前 Docker 守护程序相同） |
.Hostname | 节点主机名 |
.Status | 节点状态 |
.Availability | 节点可用性（“active”、“pause”或“drain”） |
.ManagerStatus | 节点的管理器状态 |
.TLSStatus | 节点的 TLS 状态（“Ready”或“Needs Rotation”，其 TLS 证书由旧的 CA 签名） |
.EngineVersion | 引擎版本 |
使用--format选项时，node ls命令将完全按照模板声明的输出数据，或者在使用table指令时，还包括列标题。
以下示例使用没有标题的模板，并为所有节点输出以冒号 (:) 分隔的ID、Hostname和TLS Status条目。
$ docker node ls --format "{{.ID}}: {{.Hostname}} {{.TLSStatus}}"
e216jshn25ckzbvmwlnh5jr3g: swarm-manager1 Ready
35o6tiywb700jesrt3dmllaza: swarm-worker1 Needs Rotation
要以 JSON 格式列出所有节点，请使用json指令。
$ docker node ls --format json
{"Availability":"Active","EngineVersion":"23.0.3","Hostname":"docker-desktop","ID":"k8f4w7qtzpj5sqzclcqafw35g","ManagerStatus":"Leader","Self":true,"Status":"Ready","TLSStatus":"Ready"}