构建驱动程序
目录
构建驱动程序是关于 BuildKit 后端如何以及在何处运行的配置。驱动程序设置是可自定义的,并允许对构建器进行细粒度控制。Buildx 支持以下驱动程序
docker
:使用捆绑到 Docker 守护程序中的 BuildKit 库。docker-container
:使用 Docker 创建一个专用的 BuildKit 容器。kubernetes
:在 Kubernetes 集群中创建 BuildKit Pod。remote
:直接连接到手动管理的 BuildKit 守护程序。
不同的驱动程序支持不同的用例。默认的 docker
驱动程序优先考虑简单性和易用性。它对高级功能(如缓存和输出格式)的支持有限,并且不可配置。其他驱动程序提供了更大的灵活性和更强大的高级场景处理能力。
下表概述了驱动程序之间的一些差异。
功能 | docker | docker-container | kubernetes | remote |
---|---|---|---|---|
自动加载镜像 | ✅ | |||
缓存导出 | ✓* | ✅ | ✅ | ✅ |
Tarball 输出 | ✅ | ✅ | ✅ | |
多架构镜像 | ✅ | ✅ | ✅ | |
BuildKit 配置 | ✅ | ✅ | 外部管理 |
* docker
驱动程序不支持所有缓存导出选项。有关详细信息,请参阅 缓存存储后端。
加载到本地镜像存储
与使用默认 docker
驱动程序不同,使用其他驱动程序构建的镜像不会自动加载到本地镜像存储中。如果您未指定输出,则构建结果仅导出到构建缓存。
要使用非默认驱动程序构建镜像并将其加载到镜像存储中,请将 --load
标志与构建命令一起使用
$ docker buildx build --load -t <image> --builder=container .
...
=> exporting to oci image format 7.7s
=> => exporting layers 4.9s
=> => exporting manifest sha256:4e4ca161fa338be2c303445411900ebbc5fc086153a0b846ac12996960b479d3 0.0s
=> => exporting config sha256:adf3eec768a14b6e183a1010cb96d91155a82fd722a1091440c88f3747f1f53f 0.0s
=> => sending tarball 2.8s
=> importing to docker
使用此选项,镜像在构建完成后即可在镜像存储中使用
$ docker image ls
REPOSITORY TAG IMAGE ID CREATED SIZE
<image> latest adf3eec768a1 2 minutes ago 197MB
默认加载
在 Buildx 版本 0.14.0 中引入
您可以将自定义构建驱动程序配置为与默认 docker
驱动程序类似的方式运行,并默认将镜像加载到本地镜像存储中。为此,请在创建构建器时设置 default-load
驱动程序选项
$ docker buildx create --driver-opt default-load=true
请注意,与 docker
驱动程序一样,如果您使用 --output
指定不同的输出格式,则结果不会加载到镜像存储中,除非您也显式指定 --output type=docker
或使用 --load
标志。
后续步骤
阅读每个驱动程序的说明