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