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