Dockerfile Release Notes (Versions 1.14.0 to 1.11.0)

{{< release-date date="2025-02-19" >}} The full release notes for this release are available [on GitHub](https://github.com/moby/buildkit/releases/tag/dockerfile%2F1.14.0). ```dockerfile # syntax=docker/dockerfile:1.14.0 ``` - `COPY --chmod` now allows non-octal values. This feature was previously in the labs channel and is now available in the main release. [moby/buildkit#5734](https://github.com/moby/buildkit/pull/5734) - Fix handling of OSVersion platform property if one is set by the base image [moby/buildkit#5714](https://github.com/moby/buildkit/pull/5714) - Fix errors where a named context metadata could be resolved even if it was not reachable by the current build configuration, leading to build errors [moby/buildkit#5688](https://github.com/moby/buildkit/pull/5688) ## 1.14.0 (labs) {{< release-date date="2025-02-19" >}} {{% include "dockerfile-labs-channel.md" %}} The full release notes for this release are available [on GitHub](https://github.com/moby/buildkit/releases/tag/dockerfile%2F1.14.0-labs). ```dockerfile # syntax=docker.io/docker/dockerfile-upstream:1.14.0-labs ``` - New `RUN --device=name,[required]` flag lets builds request CDI devices are available to the build step. Requires BuildKit v0.20.0+ [moby/buildkit#4056](https://github.com/moby/buildkit/pull/4056), [moby/buildkit#5738](https://github.com/moby/buildkit/pull/5738) ## 1.13.0 {{< release-date date="2025-01-20" >}} The full release notes for this release are available [on GitHub](https://github.com/moby/buildkit/releases/tag/dockerfile%2F1.13.0). ```dockerfile # syntax=docker/dockerfile:1.13.0 ``` - New `TARGETOSVERSION`, `BUILDOSVERSION` builtin build-args are available for Windows builds, and `TARGETPLATFORM` value now also contains `OSVersion` value. [moby/buildkit#5614](https://github.com/moby/buildkit/pull/5614) - Allow syntax forwarding for external frontends for files starting with a Byte Order Mark (BOM). [moby/buildkit#5645](https://github.com/moby/buildkit/pull/5645) - Default `PATH` in Windows Containers has been updated with `powershell.exe` directory. [moby/buildkit#5446](https://github.com/moby/buildkit/pull/5446) - Fix Dockerfile directive parsing to not allow invalid syntax. [moby/buildkit#5646](https://github.com/moby/buildkit/pull/5646) - Fix case where `ONBUILD` command may have run twice on inherited stage. [moby/buildkit#5593](https://github.com/moby/buildkit/pull/5593) - Fix possible missing named context replacement for child stages in Dockerfile. [moby/buildkit#5596](https://github.com/moby/buildkit/pull/5596) ## 1.13.0 (labs) {{< release-date date="2025-01-20" >}} {{% include "dockerfile-labs-channel.md" %}} The full release notes for this release are available [on GitHub](https://github.com/moby/buildkit/releases/tag/dockerfile%2F1.13.0-labs). ```dockerfile # syntax=docker.io/docker/dockerfile-upstream:1.13.0-labs ``` - Fix support for non-octal values for `COPY --chmod`. [moby/buildkit#5626](https://github.com/moby/buildkit/pull/5626) ## 1.12.0 {{< release-date date="2024-11-27" >}} The full release notes for this release are available [on GitHub](https://github.com/moby/buildkit/releases/tag/dockerfile%2F1.12.0). ```dockerfile # syntax=docker/dockerfile:1.12.0 ``` - Fix incorrect description in History line of image configuration with multiple `ARG` instructions. [moby/buildkit#5508] ## 1.11.1 {{< release-date date="2024-11-08" >}} The full release notes for this release are available [on GitHub](https://github.com/moby/buildkit/releases/tag/dockerfile%2F1.11.1). ```dockerfile # syntax=docker/dockerfile:1.11.1 ``` - Fix regression when using the `ONBUILD` instruction in stages inherited within the same Dockerfile. [moby/buildkit#5490] ## 1.11.0 {{< release-date date="2024-10-30" >}} The full release notes for this release are available [on GitHub](https://github.com/moby/buildkit/releases/tag/dockerfile%2F1.11.0). ```dockerfile # syntax=docker/dockerfile:1.11.0 ``` - The [`ONBUILD` instruction](/reference/dockerfile.md#onbuild) now supports commands that refer to other stages or images with `from`, such as `COPY --from` or `RUN mount=from=...`. [moby/buildkit#5357]

This section details the release notes for Dockerfile versions 1.14.0 to 1.11.0, including both standard and labs releases. Key updates include allowing non-octal values for `COPY --chmod`, the addition of `TARGETOSVERSION` and `BUILDOSVERSION` build-args for Windows, support for CDI devices with `RUN --device`, and fixes for various bugs related to `ONBUILD`, `ARG`, and platform handling. The notes provide links to the full release details on GitHub for each version.