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

每个构建器都有一个或多个与其关联的节点。当前构建器的名称标有*in和显式节点,以针对列中标NAME/NODE有 的目标平台进行构建。*PLATFORMS

选项

选项默认描述
--formattable格式化输出

例子

格式化输出(--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