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.tw/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）的格式為“key=value”。如果有多個過濾器，則傳遞多個標誌（例如，--filter "foo=bar" --filter "bif=baz"）

目前支援的過濾器有：

id
標籤
node.label
membership
name
role

id

id 過濾器匹配節點 ID 的全部或部分。

$ docker node ls -f id=1

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