Docker 节点 LS
| 描述 | 列出 swarm 中的节点 |
|---|---|
| 用法 | docker node ls [OPTIONS] |
| 别名 | docker node list |
群此命令适用于 Swarm 编排器。
描述
列出 Docker Swarm 管理器知道的所有节点。您可以筛选
使用-f或--filter旗。请参阅筛选部分
了解有关可用筛选条件选项的更多信息。
注意
这是一个集群管理命令，必须在 swarm 上执行 Manager 节点。要了解 Manager 和 worker，请参阅 文档。
选项
| 选择 | 违约 | 描述 |
|---|---|---|
-f, --filter | 根据提供的条件筛选输出 | |
--format | 使用自定义模板格式化输出： 'table'：以带有列标题的表格格式打印输出（默认） 'table TEMPLATE'：使用给定的 Go 模板 以表格格式打印输出'json'：以 JSON 格式 打印'TEMPLATE'：使用给定的 Go 模板打印输出。 有关使用模板设置输出格式的更多信息，请参阅 https://docs.docker.com/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”。如果还有更多
than 一个 filter，然后传递多个标志（例如--filter "foo=bar" --filter "bif=baz")
当前支持的筛选器包括：
身份证
这idfilter 匹配节点的全部或部分 ID。
$ docker node ls -f id=1
ID HOSTNAME STATUS AVAILABILITY MANAGER STATUS
1bcef6utixb0l0ca7gxuivsj0 swarm-worker2 Ready Active
标签
这labelfilter 根据引擎标签和是否存在label单独或label和一个值。引擎标签在
守护程序配置。筛选条件
群node标签， 使用node.label相反.
以下筛选条件将foolabel 的 intent 值。
$ docker node ls -f "label=foo"
ID HOSTNAME STATUS AVAILABILITY MANAGER STATUS
1bcef6utixb0l0ca7gxuivsj0 swarm-worker2 Ready Active
node.label （节点标签）
这node.labelfilter 根据节点标签和状态匹配节点
的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
显示具有regionNode 标签集：
$ 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
显示具有regionnode label（节点标签），值为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
会员
这membershipfilter 根据是否存在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筛选全部或部分节点主机名的匹配项。
以下筛选条件匹配名称等于swarm-master字符串。
$ docker node ls -f name=swarm-manager1
ID HOSTNAME STATUS AVAILABILITY MANAGER STATUS
e216jshn25ckzbvmwlnh5jr3g * swarm-manager1 Ready Active Leader
角色
这rolefilter 根据是否存在role和一个值worker或manager.
以下筛选条件将manager角色。
$ docker node ls -f "role=manager"
ID HOSTNAME STATUS AVAILABILITY MANAGER STATUS
e216jshn25ckzbvmwlnh5jr3g * swarm-manager1 Ready Active Leader
设置输出格式 （--format）
格式选项 （--format） pretty-prints 节点输出
使用 Go 模板。
下面列出了 Go 模板的有效占位符：
| 占 位 符 | 描述 |
|---|---|
.ID | 节点 ID |
.Self | 守护程序的节点 （true/false,true表示该节点与当前 Docker 守护进程相同） |
.Hostname | 节点主机名 |
.Status | 节点状态 |
.Availability | 节点可用性（“active”、“pause” 或 “drain”） |
.ManagerStatus | 节点的 Manager 状态 |
.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"}