docker buildx ls

說明	列出建置器執行個體
用法	`docker buildx ls`

說明

列出所有建置器執行個體和每個執行個體的節點。

$ docker buildx ls
NAME/NODE           DRIVER/ENDPOINT                   STATUS    BUILDKIT   PLATFORMS
elated_tesla*       docker-container
 \_ elated_tesla0    \_ unix:///var/run/docker.sock   running   v0.10.3    linux/amd64
 \_ elated_tesla1    \_ ssh://ubuntu@1.2.3.4          running   v0.10.3    linux/arm64*, linux/arm/v7, linux/arm/v6
default             docker
 \_ default          \_ default                       running   v0.8.2     linux/amd64

每個建置器都有一個或多個與之關聯的節點。目前建置器的名稱在 `NAME/NODE` 中以 `*` 標記，而用於針對目標平台建置的明確節點在 `PLATFORMS` 欄中以 `*` 標記。

選項

選項	預設值	說明
`--format`	`table (表格)`	格式化輸出
`--no-trunc`		不截斷輸出

範例

格式化輸出 (--format)

格式化選項 ( `--format` ) 使用 Go 樣板來美化建置器執行個體的輸出。

Go 樣板的有效佔位符號如下所示

佔位符號	說明
`.Name`	建置器或節點名稱
`.DriverEndpoint`	驅動程式 (適用於建置器) 或端點 (適用於節點)
`.LastActivity`	建置器上次活動時間
`.Status`	建置器或節點狀態
`.Buildkit`	節點的 BuildKit 版本
`.Platforms`	可用節點的平台
`.Error`	錯誤
`.Builder`	建置器物件

使用 `--format` 選項時，`ls` 命令會完全按照樣板宣告的格式輸出資料，或者在使用 `table` 指令時，也會包含欄標題。

以下範例使用沒有標題的樣板，並輸出以冒號 ( `:` ) 分隔的 `Name` 和 `DriverEndpoint` 項目

$ docker buildx ls --format "{{.Name}}: {{.DriverEndpoint}}"
elated_tesla: docker-container
elated_tesla0: unix:///var/run/docker.sock
elated_tesla1: ssh://ubuntu@1.2.3.4
default: docker
default: default

`Builder` 佔位符號可用於存取建置器物件及其欄位。例如，以下樣板輸出建置器和節點的名稱及其各自的端點

$ docker buildx ls --format "{{.Builder.Name}}: {{range .Builder.Nodes}}\n  {{.Name}}: {{.Endpoint}}{{end}}"
elated_tesla:
  elated_tesla0: unix:///var/run/docker.sock
  elated_tesla1: ssh://ubuntu@1.2.3.4
default: docker
  default: default