docker节点ls

描述	列出 swarm 中的节点
用法	`docker node ls [OPTIONS]`
别名	`docker node list`

Swarm 此命令与 Swarm 协调器配合使用。

描述

列出 Docker Swarm 管理器知道的所有节点。您可以使用-f或--filter标志进行过滤。有关可用过滤器选项的更多信息，请参阅过滤部分。

笔记
这是集群管理命令，必须在 swarm manager 节点上执行。要了解管理器和工作器，请参阅文档中的Swarm 模式部分。

选项

选项	默认	描述
`-f, --filter`		根据提供的条件过滤输出
`--format`		使用自定义模板设置输出格式： 'table'：以带有列标题的表格格式打印输出（默认） 'table TEMPLATE'：使用给定的 Go 模板以表格格式打印输出 'json'：以 JSON 格式打印 'TEMPLATE'：打印使用给定的 Go 模板输出。有关使用模板格式化输出的更多信息，请参阅 https://docker.github.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 守护进程是同一节点。 A *（例如， e216jshn25ckzbvmwlnh5jr3g *）表示该节点是当前的 docker 守护进程。

过滤（--filter）

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

目前支持的过滤器有：

ID
标签
节点标签
会员资格
姓名
角色

ID

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

$ docker node ls -f id=1

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

节点标签

过滤node.label器根据节点标签以及node.label单独的 a 或 anode.label和 a 值的存在来匹配节点。

以下过滤器更新节点以具有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

会员资格

过滤器根据 a和值或的membership存在来匹配节点。membershipacceptedpending

以下过滤器匹配带有membershipof 的节点accepted。

$ docker node ls -f "membership=accepted"

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

姓名

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

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

$ docker node ls -f name=swarm-manager1

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

角色

过滤器根据 a和值或的role存在来匹配节点。roleworkermanager

以下过滤器将节点与manager角色相匹配。

$ docker node ls -f "role=manager"

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

格式化输出（--format）

格式化选项 ( --format) 使用 Go 模板漂亮地打印节点输出。

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

占位符	描述
`.ID`	节点号
`.Self`	守护进程的节点（`true/false`，`true`表示该节点与当前 docker 守护进程相同）
`.Hostname`	节点主机名
`.Status`	节点状态
`.Availability`	节点可用性（“活动”、“暂停”或“耗尽”）
`.ManagerStatus`	节点管理器状态
`.TLSStatus`	节点的 TLS 状态（“就绪”或“需要轮换”具有由旧 CA 签名的 TLS 证书）
`.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"}