切换语言

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 标有 in*NAME/NODE和显式节点进行构建 在*PLATFORMS列。

选项

选择违约描述
--formattable设置输出格式
--no-trunc不截断输出

例子

设置输出格式 （--format）

格式选项 （--format） pretty-prints 构建器实例输出 使用 Go 模板。

下面列出了 Go 模板的有效占位符：

占 位 符描述
.Name生成器或节点名称
.DriverEndpointDriver （用于生成器） 或 Endpoint （用于节点）
.LastActivityBuilder 上次活动
.Status生成器或节点状态
.Buildkit节点的 BuildKit 版本
.Platforms可用节点的平台
.Error错误
.BuilderBuilder 对象

使用--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

这Builderplaceholder 可用于访问 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