centersl/docker-docs
1
0
Fork 0
mirror of https://github.com/docker/docs.git synced 2026-03-27 06:18:55 +07:00
Code Issues Packages Projects Releases Wiki Activity

ENGDOCS-3118 (#23940)

Browse Source 
<!--Delete sections as needed -->

## Description

Changes release notes for Build to point to the GitHub release pages
instead

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
This commit is contained in:
Allie Sadler
2026-01-08 09:38:05 +00:00
committed by GitHub
parent 54ca9b78c4
commit af0ff2b9d9
7 changed files with 32 additions and 2199 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
.vale.ini
View File

@@ -15,12 +15,6 @@ Vale.Terms = NO
Docker.Capitalization = NO Docker.Capitalization = NO
Docker.We = NO Docker.We = NO
[content/manuals/build/buildkit/dockerfile-release-notes.md]
Vale.Spelling = NO
Vale.Terms = NO
Docker.Capitalization = NO
Docker.We = NO
[content/manuals/*/release-notes.md] [content/manuals/*/release-notes.md]
Vale.Spelling = NO Vale.Spelling = NO
Vale.Terms = NO Vale.Terms = NO

2
content/_index.md
View File

@@ -57,7 +57,7 @@ grid:
- text: "Packaging your software" - text: "Packaging your software"
url: "/build/building/packaging/" url: "/build/building/packaging/"
- text: "Release notes" - text: "Release notes"
url: "/build/release-notes/" url: "https://github.com/docker/buildx/releases"
- title: Docker Build Cloud - title: Docker Build Cloud
icon: cloud icon: cloud
description: | description: |

2
content/manuals/build/building/cdi.md
View File

@@ -118,7 +118,7 @@ specification. In this case it uses `foo`, which is the first device in
> [!NOTE] > [!NOTE]
> [`RUN --device` command](/reference/dockerfile.md#run---device) is only > [`RUN --device` command](/reference/dockerfile.md#run---device) is only
> featured in [`labs` channel](../buildkit/frontend.md#labs-channel) since > featured in [`labs` channel](../buildkit/frontend.md#labs-channel) since
> [Dockerfile frontend v1.14.0-labs](../buildkit/dockerfile-release-notes.md#1140-labs) > [Dockerfile frontend v1.14.0-labs](https://github.com/moby/buildkit/releases/tag/dockerfile%2F1.14.0-labs)
> and not yet available in stable syntax. > and not yet available in stable syntax.
Now let's build this Dockerfile: Now let's build this Dockerfile:

635
content/manuals/build/buildkit/dockerfile-release-notes.md
View File

@@ -1,637 +1,8 @@
--- ---
title: Dockerfile release notes title: Dockerfile release notes
description: Release notes for Dockerfile frontend params:
keywords: build, dockerfile, frontend, release notes sidebar:
tags: [Release notes] goto: "https://github.com/moby/buildkit/releases"
toc_max: 2
aliases: aliases:
- /build/dockerfile/release-notes/ - /build/dockerfile/release-notes/
--- ---
This page contains information about the new features, improvements, known
issues, and bug fixes in [Dockerfile reference](/reference/dockerfile.md).
For usage, see the [Dockerfile frontend syntax](frontend.md) page.
## 1.19.0
{{< release-date date="2025-09-30" >}}
The full release notes for this release are available
[on GitHub](https://github.com/moby/buildkit/releases/tag/dockerfile%2F1.19.0).
```dockerfile
# syntax=docker/dockerfile:1.19.0
```
* The `--exclude` flag for `COPY` and `ADD` instructions is now generally available. This flag was previously available under the `labs` channel. [moby/buildkit#6232](https://github.com/moby/buildkit/pull/6232)
* Fix issue where adding `--exclude` flag to `COPY` could cause a broken symlink to fail the build. [moby/buildkit#6220](https://github.com/moby/buildkit/pull/6220)
* Fix issue where `EXPOSE` instruction did not correctly format the history record it created. [moby/buildkit#6218](https://github.com/moby/buildkit/pull/6218)
## 1.18.0
{{< release-date date="2025-09-03" >}}
The full release notes for this release are available
[on GitHub](https://github.com/moby/buildkit/releases/tag/dockerfile%2F1.18.0).
```dockerfile
# syntax=docker/dockerfile:1.18.0
```
* Add support for Git URLs for remote build contexts and `ADD` command now allows new syntax with added query parameters in `?key=value` format for better control over the Git clone procedure. Supported options in this release are `ref`, `tag`, `branch`, `checksum` (alias `commit`), `subdir`, `keep-git-dir` and `submodules`. [moby/buildkit#6172](https://github.com/moby/buildkit/pull/6172) [moby/buildkit#6173](https://github.com/moby/buildkit/pull/6173)
* Add new check rules `ExposeProtoCasing` and `ExposeInvalidFormat` to improve usage of `EXPOSE` commands. [moby/buildkit#6135](https://github.com/moby/buildkit/pull/6135)
* Fix created time not being set correctly from the base image if named context is used. [moby/buildkit#6096](https://github.com/moby/buildkit/pull/6096)
## 1.17.0
{{< release-date date="2025-06-17" >}}
The full release notes for this release are available
[on GitHub](https://github.com/moby/buildkit/releases/tag/dockerfile%2F1.17.0).
```dockerfile
# syntax=docker/dockerfile:1.17.0
```
* Add `ADD --unpack=bool` to control whether archives from a URL path are unpacked. The default is to detect unpack behavior based on the source path, as it happened in previous versions. [moby/buildkit#5991](https://github.com/moby/buildkit/pull/5991)
* Add support for `ADD --chown` when unpacking archive, similar to when copying regular files. [moby/buildkit#5987](https://github.com/moby/buildkit/pull/5987)
## 1.16.0
{{< release-date date="2025-05-22" >}}
The full release notes for this release are available
[on GitHub](https://github.com/moby/buildkit/releases/tag/dockerfile%2F1.16.0).
```dockerfile
# syntax=docker/dockerfile:1.16.0
```
* `ADD --checksum` support for Git URL. [moby/buildkit#5975](https://github.com/moby/buildkit/pull/5975)
* Allow whitespace in heredocs. [moby/buildkit#5817](https://github.com/moby/buildkit/pull/5817)
* `WORKDIR` now supports `SOURCE_DATE_EPOCH`. [moby/buildkit#5960](https://github.com/moby/buildkit/pull/5960)
* Leave default PATH environment variable set by the base image for WCOW. [moby/buildkit#5895](https://github.com/moby/buildkit/pull/5895)
## 1.15.1
{{< release-date date="2025-03-30" >}}
The full release notes for this release are available
[on GitHub](https://github.com/moby/buildkit/releases/tag/dockerfile%2F1.15.1).
```dockerfile
# syntax=docker/dockerfile:1.15.1
```
* Fix `no scan targets for linux/arm64/v8` when `--attest type=sbom` is used. [moby/buildkit#5941](https://github.com/moby/buildkit/pull/5941)
## 1.15.0
{{< release-date date="2025-04-15" >}}
The full release notes for this release are available
[on GitHub](https://github.com/moby/buildkit/releases/tag/dockerfile%2F1.15.0).
```dockerfile
# syntax=docker/dockerfile:1.15.0
```
- Build error for invalid target now shows suggestions for correct possible names. [moby/buildkit#5851](https://github.com/moby/buildkit/pull/5851)
- Fix SBOM attestation producing error for Windows targets. [moby/buildkit#5837](https://github.com/moby/buildkit/pull/5837)
- Fix recursive `ARG` producing an infinite loop when processing an outline request. [moby/buildkit#5823](https://github.com/moby/buildkit/pull/5823)
- Fix parsing syntax directive from JSON that would fail if the JSON had other datatypes than strings. [moby/buildkit#5815](https://github.com/moby/buildkit/pull/5815)
- Fix platform in image config being in unnormalized form (regression from 1.12). [moby/buildkit#5776](https://github.com/moby/buildkit/pull/5776)
- Fix copying into destination directory when directory is not present with WCOW. [moby/buildkit#5249](https://github.com/moby/buildkit/pull/5249)
## 1.14.1
{{< release-date date="2025-03-05" >}}
The full release notes for this release are available
[on GitHub](https://github.com/moby/buildkit/releases/tag/dockerfile%2F1.14.1).
```dockerfile
# syntax=docker/dockerfile:1.14.1
```
- Normalize platform in image config. [moby/buildkit#5776](https://github.com/moby/buildkit/pull/5776)
## 1.14.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]
[moby/buildkit#5508]: https://github.com/moby/buildkit/pull/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]
[moby/buildkit#5490]: https://github.com/moby/buildkit/pull/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]
[moby/buildkit#5357]: https://github.com/moby/buildkit/pull/5357
[moby/buildkit#5208]: https://github.com/moby/buildkit/pull/5208
[moby/buildkit#5414]: https://github.com/moby/buildkit/pull/5414
[moby/buildkit#5397]: https://github.com/moby/buildkit/pull/5397
[moby/buildkit#5369]: https://github.com/moby/buildkit/pull/5369
[moby/buildkit#5336]: https://github.com/moby/buildkit/pull/5336
[moby/buildkit#5431]: https://github.com/moby/buildkit/pull/5431
[moby/buildkit#5380]: https://github.com/moby/buildkit/pull/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]
[moby/buildkit#5215]: https://github.com/moby/buildkit/pull/5215
[moby/buildkit#5213]: https://github.com/moby/buildkit/pull/5213
[moby/buildkit#5146]: https://github.com/moby/buildkit/pull/5146
[moby/buildkit#5151]: https://github.com/moby/buildkit/pull/5151
[moby/buildkit#5148]: https://github.com/moby/buildkit/pull/5148
[moby/buildkit#5245]: https://github.com/moby/buildkit/pull/5245
[moby/buildkit#5197]: https://github.com/moby/buildkit/pull/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/)
- Fix a regression where `COPY --link` with a destination path of `.` could fail. [moby/buildkit#5080](https://github.com/moby/buildkit/pull/5080/)
- Fix validation of `ADD --checksum` when used with a Git URL. [moby/buildkit#5085](https://github.com/moby/buildkit/pull/5085/)
## 1.8.1
{{< release-date date="2024-06-18" >}}
The full release notes for this release are available
[on GitHub](https://github.com/moby/buildkit/releases/tag/dockerfile%2F1.8.1).
```dockerfile
# syntax=docker/dockerfile:1.8.1
```
### Bug fixes and enhancements
- Fix handling of empty strings on variable expansion. [moby/buildkit#5052](https://github.com/moby/buildkit/pull/5052/)
- Improve formatting of build warnings. [moby/buildkit#5037](https://github.com/moby/buildkit/pull/5037/), [moby/buildkit#5045](https://github.com/moby/buildkit/pull/5045/), [moby/buildkit#5046](https://github.com/moby/buildkit/pull/5046/)
- Fix possible invalid output for `UndeclaredVariable` warning for multi-stage builds. [moby/buildkit#5048](https://github.com/moby/buildkit/pull/5048/)
## 1.8.0
{{< release-date date="2024-06-11" >}}
The full release notes for this release are available
[on GitHub](https://github.com/moby/buildkit/releases/tag/dockerfile%2F1.8.0).
```dockerfile
# syntax=docker/dockerfile:1.8.0
```
- Many new validation rules have been added to verify that your Dockerfile is using best practices. These rules are validated during build and new `check` frontend method can be used to only trigger validation without completing the whole build.
- New directive `#check` and build argument `BUILDKIT_DOCKERFILE_CHECK` lets you control the behavior or build checks. [moby/buildkit#4962](https://github.com/moby/buildkit/pull/4962/)
- Using a single-platform base image that does not match your expected platform is now validated. [moby/buildkit#4924](https://github.com/moby/buildkit/pull/4924/)
- Errors from the expansion of `ARG` definitions in global scope are now handled properly. [moby/buildkit#4856](https://github.com/moby/buildkit/pull/4856/)
- Expansion of the default value of `ARG` now only happens if it is not overwritten by the user. Previously, expansion was completed and value was later ignored, which could result in an unexpected expansion error. [moby/buildkit#4856](https://github.com/moby/buildkit/pull/4856/)
- Performance of parsing huge Dockerfiles with many stages has been improved. [moby/buildkit#4970](https://github.com/moby/buildkit/pull/4970/)
- Fix some Windows path handling consistency errors. [moby/buildkit#4825](https://github.com/moby/buildkit/pull/4825/)
## 1.7.0
{{< release-date date="2024-03-06" >}}
### Stable
```dockerfile
# syntax=docker/dockerfile:1.7
```
- Variable expansion now allows string substitutions and trimming.
[moby/buildkit#4427](https://github.com/moby/buildkit/pull/4427),
[moby/buildkit#4287](https://github.com/moby/buildkit/pull/4287)
- Named contexts with local sources now correctly transfer only the files used in the Dockerfile instead of the full source directory.
[moby/buildkit#4161](https://github.com/moby/buildkit/pull/4161)
- Dockerfile now better validates the order of stages and returns nice errors with stack traces if stages are in incorrect order.
[moby/buildkit#4568](https://github.com/moby/buildkit/pull/4568),
[moby/buildkit#4567](https://github.com/moby/buildkit/pull/4567)
- History commit messages now contain flags used with `COPY` and `ADD`.
[moby/buildkit#4597](https://github.com/moby/buildkit/pull/4597)
- Progress messages for `ADD` commands from Git and HTTP sources have been improved.
[moby/buildkit#4408](https://github.com/moby/buildkit/pull/4408)
### Labs
```dockerfile
# syntax=docker/dockerfile:1.7-labs
```
- New `--parents` flag has been added to `COPY` for copying files while keeping the parent directory structure.
[moby/buildkit#4598](https://github.com/moby/buildkit/pull/4598),
[moby/buildkit#3001](https://github.com/moby/buildkit/pull/3001),
[moby/buildkit#4720](https://github.com/moby/buildkit/pull/4720),
[moby/buildkit#4728](https://github.com/moby/buildkit/pull/4728),
[docs](/reference/dockerfile.md#copy---parents)
- New `--exclude` flag can be used in `COPY` and `ADD` commands to apply filter to copied files.
[moby/buildkit#4561](https://github.com/moby/buildkit/pull/4561),
[docs](/reference/dockerfile.md#copy---exclude)
## 1.6.0
{{< release-date date="2023-06-13" >}}
### New
- Add `--start-interval` flag to the
[`HEALTHCHECK` instruction](/reference/dockerfile.md#healthcheck).
The following features have graduated from the labs channel to stable:
- The `ADD` instruction can now [import files directly from Git URLs](/reference/dockerfile.md#adding-a-git-repository-add-git-ref-dir)
- The `ADD` instruction now supports [`--checksum` flag](/reference/dockerfile.md#verifying-a-remote-file-checksum-add---checksumchecksum-http-src-dest)
to validate the contents of the remote URL contents
### Bug fixes and enhancements
- Variable substitution now supports additional POSIX compatible variants without `:`.
[moby/buildkit#3611](https://github.com/moby/buildkit/pull/3611)
- Exported Windows images now contain OSVersion and OSFeatures values from base image.
[moby/buildkit#3619](https://github.com/moby/buildkit/pull/3619)
- Changed the permissions for Heredocs to 0644.
[moby/buildkit#3992](https://github.com/moby/buildkit/pull/3992)
## 1.5.2
{{< release-date date="2023-02-14" >}}
### Bug fixes and enhancements
- Fix building from Git reference that is missing branch name but contains a
subdir
- 386 platform image is now included in the release
## 1.5.1
{{< release-date date="2023-01-18" >}}
### Bug fixes and enhancements
- Fix possible panic when warning conditions appear in multi-platform builds
## 1.5.0 (labs)
{{< release-date date="2023-01-10" >}}
{{% include "dockerfile-labs-channel.md" %}}
### New
- `ADD` command now supports [`--checksum` flag](/reference/dockerfile.md#verifying-a-remote-file-checksum-add---checksumchecksum-http-src-dest)
to validate the contents of the remote URL contents
## 1.5.0
{{< release-date date="2023-01-10" >}}
### New
- `ADD` command can now [import files directly from Git URLs](/reference/dockerfile.md#adding-a-git-repository-add-git-ref-dir)
### Bug fixes and enhancements
- Named contexts now support `oci-layout://` protocol for including images from
local OCI layout structure
- Dockerfile now supports secondary requests for listing all build targets or
printing outline of accepted parameters for a specific build target
- Dockerfile `#syntax` directive that redirects to an external frontend image
now allows the directive to be also set with `//` comments or JSON. The file
may also contain a shebang header
- Named context can now be initialized with an empty scratch image
- Named contexts can now be initialized with an SSH Git URL
- Fix handling of `ONBUILD` when importing Schema1 images
## 1.4.3
{{< release-date date="2022-08-23" >}}
### Bug fixes and enhancements
- Fix creation timestamp not getting reset when building image from
`docker-image://` named context
- Fix passing `--platform` flag of `FROM` command when loading
`docker-image://` named context
## 1.4.2
{{< release-date date="2022-05-06" >}}
### Bug fixes and enhancements
- Fix loading certain environment variables from an image passed with built
context
## 1.4.1
{{< release-date date="2022-04-08" >}}
### Bug fixes and enhancements
- Fix named context resolution for cross-compilation cases from input when input
is built for a different platform
## 1.4.0
{{< release-date date="2022-03-09" >}}
### New
- [`COPY --link` and `ADD --link`](/reference/dockerfile.md#copy---link)
allow copying files with increased cache efficiency and rebase images without
requiring them to be rebuilt. `--link` copies files to a separate layer and
then uses new LLB MergeOp implementation to chain independent layers together
- [Heredocs](/reference/dockerfile.md#here-documents) support have
been promoted from labs channel to stable. This feature allows writing
multiline inline scripts and files
- Additional [named build contexts](/reference/cli/docker/buildx/build.md#build-context)
can be passed to build to add or overwrite a stage or an image inside the
build. A source for the context can be a local source, image, Git, or HTTP URL
- [`BUILDKIT_SANDBOX_HOSTNAME` build-arg](/reference/dockerfile.md#buildkit-built-in-build-args)
can be used to set the default hostname for the `RUN` steps
### Bug fixes and enhancements
- When using a cross-compilation stage, the target platform for a step is now
seen on progress output
- Fix some cases where Heredocs incorrectly removed quotes from content
## 1.3.1
{{< release-date date="2021-10-04" >}}
### Bug fixes and enhancements
- Fix parsing "required" mount key without a value
## 1.3.0 (labs)
{{< release-date date="2021-07-16" >}}
{{% include "dockerfile-labs-channel.md" %}}
### New
- `RUN` and `COPY` commands now support [Here-document syntax](/reference/dockerfile.md#here-documents)
allowing writing multiline inline scripts and files
## 1.3.0
{{< release-date date="2021-07-16" >}}
### New
- `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. 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

1544
content/manuals/build/release-notes.md
View File

File diff suppressed because it is too large Load Diff

6
data/redirects.yml
View File

@@ -410,3 +410,9 @@
- /compose/releases/release-notes/ - /compose/releases/release-notes/
- /compose/releases/prior-releases/ - /compose/releases/prior-releases/
- /release-notes/docker-compose/ - /release-notes/docker-compose/
# Build release notes
"https://github.com/docker/buildx/releases":
- /build/release-notes/
"https://github.com/moby/buildkit/releases/":
- /build/buildkit/dockerfile-release-notes/

34
data/summary.yaml
View File

@@ -27,45 +27,45 @@ Build additional contexts:
requires: Docker Compose [2.17.0](https://github.com/docker/compose/releases/tag/v2.17.0) and later requires: Docker Compose [2.17.0](https://github.com/docker/compose/releases/tag/v2.17.0) and later
Build checks: Build checks:
availability: Beta availability: Beta
requires: Docker Buildx [0.15.0](/manuals/build/release-notes.md#0150) and later requires: Docker Buildx [0.15.0](https://github.com/docker/buildx/releases/tag/v0.15.0) and later
Build dockerfile inline: Build dockerfile inline:
requires: Docker Compose [2.17.0](https://github.com/docker/compose/releases/tag/v2.17.0) and later requires: Docker Compose [2.17.0](https://github.com/docker/compose/releases/tag/v2.17.0) and later
Build entitlements: Build entitlements:
requires: Docker Compose [2.27.1](https://github.com/docker/compose/releases/tag/v2.27.1) and later requires: Docker Compose [2.27.1](https://github.com/docker/compose/releases/tag/v2.27.1) and later
Build multiple exporters: Build multiple exporters:
requires: Docker Buildx [0.13.0](/manuals/build/release-notes.md#0130) and later requires: Docker Buildx [0.13.0](https://github.com/docker/buildx/releases/tag/v0.13.0) and later
Build URL Queries: Build URL Queries:
requires: Docker Buildx [0.28.0](/manuals/build/release-notes.md#0280) and later, Dockerfile [1.18.0](/manuals/build/buildkit/dockerfile-release-notes.md#1180) and later, and Docker Desktop [4.46.0](/manuals/desktop/release-notes.md#4460) and later requires: Docker Buildx [0.28.0](https://github.com/docker/buildx/releases/tag/v0.28.0) and later, Dockerfile [1.18.0](https://github.com/moby/buildkit/releases/tag/dockerfile%2F1.18.0) and later, and Docker Desktop [4.46.0](/manuals/desktop/release-notes.md#4460) and later
Buildkit host: Buildkit host:
requires: Docker Buildx [0.9.0](/manuals/build/release-notes.md#090) and later requires: Docker Buildx [0.9.0](https://github.com/docker/buildx/releases/tag/v0.9.0) and later
Build privileged: Build privileged:
requires: Docker Compose [2.15.0](https://github.com/docker/compose/releases/tag/v2.15.0) and later requires: Docker Compose [2.15.0](https://github.com/docker/compose/releases/tag/v2.15.0) and later
Build ulimits: Build ulimits:
requires: Docker Compose [2.23.1](https://github.com/docker/compose/releases/tag/v2.23.1) and later requires: Docker Compose [2.23.1](https://github.com/docker/compose/releases/tag/v2.23.1) and later
Buildx bake file: Buildx bake file:
requires: Docker Buildx [0.26.0](/manuals/build/release-notes.md#0260) and later requires: Docker Buildx [0.26.0](https://github.com/docker/buildx/releases/tag/v0.26.0) and later
Buildx bake file separator: Buildx bake file separator:
requires: Docker Buildx [0.26.0](/manuals/build/release-notes.md#0260) and later requires: Docker Buildx [0.26.0](https://github.com/docker/buildx/releases/tag/v0.26.0) and later
Buildx bake Git auth token: Buildx bake Git auth token:
requires: Docker Buildx [0.14.0](/manuals/build/release-notes.md#0140) and later requires: Docker Buildx [0.14.0](https://github.com/docker/buildx/releases/tag/v0.14.0) and later
Buildx bake Git SSH: Buildx bake Git SSH:
requires: Docker Buildx [0.14.0](/manuals/build/release-notes.md#0140) and later requires: Docker Buildx [0.14.0](https://github.com/docker/buildx/releases/tag/v0.14.0) and later
Buildx CPU profile: Buildx CPU profile:
requires: Docker Buildx [0.18.0](/manuals/build/release-notes.md#0180) and later requires: Docker Buildx [0.18.0](https://github.com/docker/buildx/releases/tag/v0.18.0) and later
Buildx Git check dirty: Buildx Git check dirty:
requires: Docker Buildx [0.10.4](/manuals/build/release-notes.md#0104) and later requires: Docker Buildx [0.10.4](https://github.com/docker/buildx/releases/tag/v0.10.4) and later
Buildx Git info: Buildx Git info:
requires: Docker Buildx [0.10.0](/manuals/build/release-notes.md#0100) and later requires: Docker Buildx [0.10.0](https://github.com/docker/buildx/releases/tag/v0.10.0) and later
Buildx Git labels: Buildx Git labels:
requires: Docker Buildx [0.10.0](/manuals/build/release-notes.md#0100) and later requires: Docker Buildx [0.10.0](https://github.com/docker/buildx/releases/tag/v0.10.0) and later
Buildx mem profile: Buildx mem profile:
requires: Docker Buildx [0.18.0](/manuals/build/release-notes.md#0180) and later requires: Docker Buildx [0.18.0](https://github.com/docker/buildx/releases/tag/v0.18.0) and later
Buildx metadata provenance: Buildx metadata provenance:
requires: Docker Buildx [0.14.0](/manuals/build/release-notes.md#0140) and later requires: Docker Buildx [0.14.0](https://github.com/docker/buildx/releases/tag/v0.14.0) and later
Buildx metadata warnings: Buildx metadata warnings:
requires: Docker Buildx [0.16.0](/manuals/build/release-notes.md#0160) and later requires: Docker Buildx [0.16.0](https://github.com/docker/buildx/releases/tag/v0.16.0) and later
Buildx no default: Buildx no default:
requires: Docker Buildx [0.10.4](/manuals/build/release-notes.md#0104) and later requires: Docker Buildx [0.10.4](https://github.com/docker/buildx/releases/tag/v0.10.4) and later
Cache backend API: Cache backend API:
availability: Experimental availability: Experimental
cagent: cagent:
@@ -233,7 +233,7 @@ Intune:
Jamf Pro: Jamf Pro:
for: Administrators for: Administrators
Load by default: Load by default:
requires: Docker Buildx [0.14.0](/manuals/build/release-notes.md#0140) and later requires: Docker Buildx [0.14.0](https://github.com/docker/buildx/releases/tag/v0.14.0) and later
MSI installer: MSI installer:
subscription: [Business] subscription: [Business]
requires: Docker Desktop [4.32](/manuals/desktop/release-notes.md#4320) and later requires: Docker Desktop [4.32](/manuals/desktop/release-notes.md#4320) and later