Dockerfile Release Notes (Versions 1.12.0 to 1.9.0)

[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] - The [`SecretsUsedInArgOrEnv`](/reference/build-checks/secrets-used-in-arg-or-env.md) build check has been improved to reduce false positives. [moby/buildkit#5208] - A new [`InvalidDefinitionDescription`](/reference/build-checks/invalid-definition-description.md) build check recommends formatting comments for build arguments and stages descriptions. This is an [experimental check](/manuals/build/checks.md#experimental-checks). [moby/buildkit#5208], [moby/buildkit#5414] - Multiple fixes for the `ONBUILD` instruction's progress and error handling. [moby/buildkit#5397] - Improved error reporting for missing flag errors. [moby/buildkit#5369] - Enhanced progress output for secret values mounted as environment variables. [moby/buildkit#5336] - Added built-in build argument `TARGETSTAGE` to expose the name of the (final) target stage for the current build. [moby/buildkit#5431] ## 1.11.0 (labs) {{% include "dockerfile-labs-channel.md" %}} - `COPY --chmod` now supports non-octal values. [moby/buildkit#5380] ## 1.10.0 {{< release-date date="2024-09-10" >}} The full release notes for this release are available [on GitHub](https://github.com/moby/buildkit/releases/tag/dockerfile%2F1.10.0). ```dockerfile # syntax=docker/dockerfile:1.10.0 ``` - [Build secrets](/manuals/build/building/secrets.md#target) can now be mounted as environment variables using the `env=VARIABLE` option. [moby/buildkit#5215] - The [`# check` directive](/reference/dockerfile.md#check) now allows new experimental attribute for enabling experimental validation rules like `CopyIgnoredFile`. [moby/buildkit#5213] - Improve validation of unsupported modifiers for variable substitution. [moby/buildkit#5146] - `ADD` and `COPY` instructions now support variable interpolation for build arguments for the `--chmod` option values. [moby/buildkit#5151] - Improve validation of the `--chmod` option for `COPY` and `ADD` instructions. [moby/buildkit#5148] - Fix missing completions for size and destination attributes on mounts. [moby/buildkit#5245] - OCI annotations are now set to the Dockerfile frontend release image. [moby/buildkit#5197] ## 1.9.0 {{< release-date date="2024-07-11" >}} The full release notes for this release are available [on GitHub](https://github.com/moby/buildkit/releases/tag/dockerfile%2F1.9.0). ```dockerfile # syntax=docker/dockerfile:1.9.0 ``` - Add new validation rules: - `SecretsUsedInArgOrEnv` - `InvalidDefaultArgInFrom` - `RedundantTargetPlatform` - `CopyIgnoredFile` (experimental) - `FromPlatformFlagConstDisallowed` - Many performance improvements for working with big Dockerfiles. [moby/buildkit#5067](https://github.com/moby/buildkit/pull/5067/), [moby/buildkit#5029](https://github.com/moby/buildkit/pull/5029/) - Fix possible panic when building Dockerfile without defined stages. [moby/buildkit#5150](https://github.com/moby/buildkit/pull/5150/) - Fix incorrect JSON parsing that could cause some incorrect JSON values to pass without producing an error. [moby/buildkit#5107](https://github.com/moby/buildkit/pull/5107/)

This section details the release notes for Dockerfile versions 1.12.0 to 1.9.0. Key updates include fixes for issues related to the `ONBUILD` instruction, improvements to build checks and validation rules (e.g., `SecretsUsedInArgOrEnv`, `InvalidDefaultArgInFrom`), the ability to mount build secrets as environment variables, variable interpolation support for the `--chmod` option in `ADD` and `COPY` instructions, and performance improvements for large Dockerfiles. The notes provide links to the full release details on GitHub for each version.