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` 列中用 `*` 標記。

選項

選項預設值描述
--formattable格式化輸出
--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