构建驱动程序

构建驱动程序是 BuildKit 后端运行方式和位置的配置。驱动程序设置是可自定义的,并允许对构建器进行细粒度控制。Buildx 支持以下驱动程序

  • docker: 使用捆绑到 Docker 守护进程的 BuildKit 库。
  • docker-container: 使用 Docker 创建一个专用的 BuildKit 容器。
  • kubernetes: 在 Kubernetes 集群中创建 BuildKit Pod。
  • remote: 直接连接到手动管理的 BuildKit 守护进程。

不同的驱动程序支持不同的用例。默认的 docker 驱动程序优先考虑简单性和易用性。它对高级功能(如缓存和输出格式)的支持有限,并且不可配置。其他驱动程序提供了更大的灵活性和更适合处理高级场景。

下表概述了驱动程序之间的一些差异。

功能dockerdocker-containerkubernetesremote
自动加载镜像
缓存导出✓*
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 标志。

下一步

阅读有关每个驱动程序的信息