docker node ls

說明列出 Swarm 中的節點
用法docker node ls [選項]
別名
docker node list

Swarm 此指令適用於 Swarm Orchestrator。

說明

列出 Docker Swarm 管理器知道的所有節點。您可以使用 -f 或 --filter 旗標進行篩選。有關可用篩選選項的更多資訊，請參閱篩選章節。

注意事項

這是一個叢集管理指令，必須在 Swarm 管理器節點上執行。要了解管理器和工作節點，請參閱文件中Swarm 模式章節。

選項

選項預設值說明
-f, --filter根據提供的條件篩選輸出
--format使用自訂範本格式化輸出
'table'：以表格格式列印輸出，包含欄位標題（預設）
'table 範本'：使用指定的 Go 範本以表格格式列印輸出
'json'：以 JSON 格式列印
'範本'：使用指定的 Go 範本列印輸出。
如需更多關於使用範本格式化輸出的資訊，請參閱 https://docker-docs.dev.org.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 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 簽署的）
.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"}