docker node ls

描述列出 swarm 中的节点
用法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.docker.net.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 daemon 是同一个节点。一个 *（例如，e216jshn25ckzbvmwlnh5jr3g *）表示该节点是当前的 docker daemon。

过滤 (--filter)

过滤标志 (-f 或 --filter) 的格式是 "key=value"。如果存在多个过滤器，则传递多个标志（例如，--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 和值来匹配节点。引擎标签在daemon 配置中配置。要过滤 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
.Selfdaemon 节点 (true/false, true 表示该节点与当前的 docker daemon 相同)
.Hostname节点主机名
.Status节点状态
.Availability节点可用性（"active"、"pause" 或 "drain"）
.ManagerStatus节点的管理器状态
.TLSStatus节点的 TLS 状态（"Ready"，或 "Needs Rotation" 表示 TLS 证书由旧 CA 签名）
.EngineVersionEngine 版本

使用 --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"}