自定义 Dockerfile 语法

Dockerfile 前端

BuildKit 支持从容器镜像动态加载前端。要使用外部 Dockerfile 前端，您的 Dockerfile 的第一行需要设置 syntax 指令指向您要使用的特定镜像

# syntax=[remote image reference]

例如

# syntax=docker/dockerfile:1
# syntax=docker.io/docker/dockerfile:1
# syntax=example.com/user/repo:tag@sha256:abcdef...

您也可以使用预定义的 BUILDKIT_SYNTAX 构建参数在命令行上设置前端镜像引用

$ docker build --build-arg BUILDKIT_SYNTAX=docker/dockerfile:1 .

这定义了用于构建 Dockerfile 的 Dockerfile 语法的存储位置。BuildKit 后端允许无缝使用作为 Docker 镜像分发的外部实现，并在容器沙箱环境中执行。

自定义 Dockerfile 实现允许您

注意
BuildKit 附带内置的 Dockerfile 前端，但建议使用外部镜像来确保所有用户在构建器上使用相同版本，并自动获取错误修复，而无需等待 BuildKit 或 Docker Engine 的新版本。

Docker 在 Docker Hub 上的 docker/dockerfile 仓库中分发了官方版本的镜像，这些镜像可用于构建 Dockerfile。有两个发布新镜像的通道：stable 和 labs。

stable 通道遵循语义化版本控制. 例如

我们建议使用 docker/dockerfile:1，它始终指向版本 1 语法的最新稳定版本，并在版本 1 发布周期中接收“次要”和“修补程序”更新。BuildKit 在执行构建时会自动检查语法的更新，确保您使用的是最新版本。

如果使用特定版本（例如 1.2 或 1.2.1），则需要手动更新 Dockerfile 才能继续接收错误修复和新功能。Dockerfile 的旧版本与构建器的新版本兼容。

labs 通道提供了对尚未在 stable 通道中提供的 Dockerfile 功能的抢先体验。labs 镜像与稳定版本同时发布，并遵循相同的版本模式，但使用 -labs 后缀，例如

选择最适合您需求的通道。如果您想从新功能中获益，请使用 labs 通道。labs 通道中的镜像包含 stable 通道中的所有功能，以及抢先体验功能。labs 通道中的稳定功能遵循语义化版本控制，但抢先体验功能不遵循，较新版本可能不向后兼容。固定版本以避免处理重大更改。