Dockerfile Release Notes (Versions 1.2.1 to 1.1.0)

for requesting a specific type of network conditions. `--network=host` requires allowing `network.host` entitlement. This feature was previously only available on labs channel ### Bug fixes and enhancements - `ADD` command with a remote URL input now correctly handles the `--chmod` flag - Values for [`RUN --mount` flag](/reference/dockerfile.md#run---mount) now support variable expansion, except for the `from` field - Allow [`BUILDKIT_MULTI_PLATFORM` build arg](/reference/dockerfile.md#buildkit-built-in-build-args) to force always creating multi-platform image, even if only contains single platform ## 1.2.1 (labs) {{< release-date date="2020-12-12" >}} {{% include "dockerfile-labs-channel.md" %}} ### Bug fixes and enhancements - `RUN` command allows [`--network` flag](/reference/dockerfile.md#run---network) for requesting a specific type of network conditions. `--network=host` requires allowing `network.host` entitlement ## 1.2.1 {{< release-date date="2020-12-12" >}} ### Bug fixes and enhancements - Revert "Ensure ENTRYPOINT command has at least one argument" - Optimize processing `COPY` calls on multi-platform cross-compilation builds ## 1.2.0 (labs) {{< release-date date="2020-12-03" >}} {{% include "dockerfile-labs-channel.md" %}} ### Bug fixes and enhancements - Experimental channel has been renamed to _labs_ ## 1.2.0 {{< release-date date="2020-12-03" >}} ### New - [`RUN --mount` syntax](/reference/dockerfile.md#run---mount) for creating secret, ssh, bind, and cache mounts have been moved to mainline channel - [`ARG` command](/reference/dockerfile.md#arg) now supports defining multiple build args on the same line similarly to `ENV` ### Bug fixes and enhancements - Metadata load errors are now handled as fatal to avoid incorrect build results - Allow lowercase Dockerfile name - `--chown` flag in `ADD` now allows parameter expansion - `ENTRYPOINT` requires at least one argument to avoid creating broken images ## 1.1.7 {{< release-date date="2020-04-18" >}} ### Bug fixes and enhancements - Forward `FrontendInputs` to the gateway ## 1.1.2 (labs) {{< release-date date="2019-07-31" >}} {{% include "dockerfile-labs-channel.md" %}} ### Bug fixes and enhancements - Allow setting security mode for a process with `RUN --security=sandbox|insecure` - Allow setting uid/gid for [cache mounts](/reference/dockerfile.md#run---mounttypecache) - Avoid requesting internally linked paths to be pulled to build context - Ensure missing cache IDs default to target paths - Allow setting namespace for cache mounts with [`BUILDKIT_CACHE_MOUNT_NS` build arg](/reference/dockerfile.md#buildkit-built-in-build-args) ## 1.1.2 {{< release-date date="2019-07-31" >}} ### Bug fixes and enhancements - Fix workdir creation with correct user and don't reset custom ownership - Fix handling empty build args also used as `ENV` - Detect circular dependencies ## 1.1.0 {{< release-date date="2019-04-27" >}} ### New - `ADD/COPY` commands now support implementation based on `llb.FileOp` and do not require helper image if builtin file operations support is available - `--chown` flag for `COPY` command now supports variable expansion ### Bug fixes and enhancements - To find the files ignored from the build context Dockerfile frontend will first look for a file `<path/to/Dockerfile>.dockerignore` and if it is not found `.dockerignore` file will be looked up from the root of the build context. This allows projects with multiple Dockerfiles to use different `.dockerignore` definitions

This section summarizes Dockerfile releases from 1.2.1 to 1.1.0. Key features include `--network` flag for `RUN` (1.2.1 labs), `RUN --mount` syntax & multi-arg `ARG` (1.2.0), plus `ADD/COPY` improvements (1.1.0). Bug fixes address ENTRYPOINT issues (1.2.1), metadata loading (1.2.0), workdir creation/dependencies (1.1.2). 1.2.0 labs renames experimental channel. 1.1.7 forwards FrontendInputs. 1.1.2 labs adds security modes/cache mount options. 1.1.0 enhances `.dockerignore` handling and offers llb.FileOp for ADD/COPY.