Welcome to the v0.12.1 release of buildx!
Please try out the release binaries and report any issues at https://github.com/docker/buildx/issues.
Previous release can be found at v0.12.0
Welcome to the 0.12.0 release of buildx!
Please try out the release binaries and report any issues at https://github.com/docker/buildx/issues.
--annotation flag for the build command and annotations key in the Bake file. Annotations added to OCI manifests, indexes, and descriptors. #2020 #2098debug command and interactive debugging console. This feature currently requires setting BUILDX_EXPERIMENTAL=1 #2006 #1896 #1970 #1914 #2026 #2086 docshost-gateway IP mapping can now be used with the --add-host flag during build #1894 #2083Previous release can be found at v0.11.2
Welcome to the 0.12.0-rc2 release of buildx! This is a pre-release of buildx
Please try out the release binaries and report any issues at https://github.com/docker/buildx/issues.
This release has no dependency changes
Previous release can be found at v0.12.0-rc1
Welcome to the 0.12.0-rc1 release of buildx! This is a pre-release of buildx
Please try out the release binaries and report any issues at https://github.com/docker/buildx/issues.
--annotation flag for the build command and annotations key in the Bake file. Annotations added to OCI manifests, indexes, and descriptors. #2020 #2098debug command and interactive debugging console. This feature currently requires setting BUILDX_EXPERIMENTAL=1 #2006 #1896 #1970 #1914 #2026 #2086 docshost-gateway IP mapping can now be used with the --add-host flag during build #1894 #2083Previous release can be found at v0.11.2
Welcome to the v0.11.2 release of buildx!
Please try out the release binaries and report any issues at https://github.com/docker/buildx/issues.
KUBECONFIG path from the instance store #1941Previous release can be found at v0.11.1
Welcome to the v0.11.1 release of buildx!
Please try out the release binaries and report any issues at https://github.com/docker/buildx/issues.
Fix a regression for bake where services in profiles would not be loaded. #1903
Fix a regression where --cgroup-parent option had no effect during build. #1913
Fix a regression where valid docker contexts could fail buildx builder name validation. #1879
Fix an issue where the host-gateway special address could not be used as an argument to --add-host. #1894 (also requires https://github.com/moby/moby/pull/45767)
Fix a possible panic when terminal is resized during the build. #1929
Previous release can be found at v0.11.0
Welcome to the v0.11.0 release of buildx!
Please try out the release binaries and report any issues at https://github.com/docker/buildx/issues.
--load now supports loading multi-platform images when used with the containerd image store in moby #1813
Commands now display the current builder name in the build progress output #1177
Bake now supports matrix builds. The new matrix field on target blocks allows easily creating multiple similar sets of targets to remove duplication in bake files #1690 docs
New experimental --detach flag for the build command to run the build in a detached server, allowing attaching to the build later using debug-shell (requires BUILDX_EXPERIMENTAL=1) #1296 #1620 #1614 #1737 #1755
docs
New monitor mode commands exec and attach to allow spawning additional processes in a debugging session (requires BUILDX_EXPERIMENTAL=1) #1626 docs
New experimental debug-shell command to directly start the build debugging monitor without starting a build, allowing connecting to previously --detached builds (requires BUILDX_EXPERIMENTAL=1) #1640
docs
New experimental --invoke=on-error option for the --invoke command to start the build debugging monitor at the point at which a build fails (requires BUILDX_EXPERIMENTAL=1) #1640 docs
Bake now supports detecting compose.yml/compose.yaml files in addition to docker-compose.yml/docker-compose.yaml #1752
Bake now supports new compose build keys dockerfile_inline and additional_contexts #1784 docs
Bake now supports replace HCL function #1720
Initial support for CLI command completion, including: builder names, folder names for build commands and bake targets #1727
Builds support the new EXPERIMENTAL_BUILDKIT_SOURCE_POLICY environment variable to set the path to a source policy docs #1628
BuildKit versions are correctly displayed in buildx ls and buildx inspect for builders using the Docker driver #1552
Display additional builder node details in buildx inspect view #1440 #1854
Builders using the remote driver allow using TLS without proving its own key/cert (if BuildKit remote is configured to support it) #1693
Builders using the kubernetes driver allow automatically generating the node name if not provided #1673
Builders using the kubernetes driver support a new serviceaccount option, which will set the created pod's serviceAccountName #1597
Builders using the kubernetes driver support the proxy-url kubeconfig option docs #1780
Bake now allows merging multiple similar attestation parameters into a single parameter to allow overriding with a single global value #1699
Fix possible panic when no builders are available #1732
Fix docker-container driver hang on container panic #1772
Fix invalid path when writing certificates for docker-container driver on Windows #1831
Fix bake failure when remote bake file is accessed using SSH #1711 #1734
Fix bake failure when remote bake context is incorrectly resolved #1783
Fix path resolution of BAKE_CMD_CONTEXT and cwd:// paths in bake contexts #1840
Fix mixed OCI and Docker media types when creating images using imagetools create #1797
Fix mismatched image id between --iidfile and -q #1844
Fix opaque error messages on invalid edge-case git urls #1710 #1733
Fix previously discarded error messages from logrus #1853
Fix AWS authentication when mixing static creds and IAM profiles #1816
Fix race in printer so that logrus warning messages appear at the end of the build deterministically #1794
Fix connection leak for feature check on default docker driver #1776
Previous release can be found at v0.10.4
Welcome to the v0.11.0-rc2 release of buildx!
This is a pre-release of buildx
Please try out the release binaries and report any issues at https://github.com/docker/buildx/issues.
--load now supports loading multi-platform images when used with the containerd image store #1813
Display additional builder node details in buildx inspect view #1440 #1854
Bake now allows merging multiple similar attestation parameters into a single parameter to allow overriding with a single global value #1699
Fix invalid path when writing certificates for docker-container driver on Windows #1831
Fix path resolution of BAKE_CMD_CONTEXT and cwd:// paths in bake contexts #1840
Fix mixed OCI and Docker media types when creating images using imagetools create #1797
Fix mismatched image id between --iidfile and -q #1844
Fix previously discarded error messages from logrus #1853
Fix AWS authentication when mixing static creds and IAM profiles #1816
Fix progress output hang when using BUILDX_EXPERIMENTAL=1 #1804
Previous release can be found at v0.11.0-rc1
Welcome to the 0.10.5 release of buildx!
Please try out the release binaries and report any issues at https://github.com/docker/buildx/issues.
Note
Buildx v0.10 enables support for a minimal SLSA Provenance attestation, which requires support for OCI-compliant multi-platform images. This may introduce issues with registry and runtime support (e.g. Google Cloud Run and Lambda). You can optionally disable the default provenance attestation functionality using
--provenance=false.
NO_COLOR with empty value #1815Welcome to the v0.11.0-rc1 release of buildx!
This is a pre-release of buildx
Please try out the release binaries and report any issues at https://github.com/docker/buildx/issues.
Commands now display the current builder name in the build progress output #1177
Bake now supports matrix builds. The new matrix field on target blocks allows easily creating multiple similar sets of targets #1690 docs
The build command now saves local paths from previous builds to the builder local state #1735
New experimental --detach flag for the build command to run the build in a detached server, allowing attaching to the build later using debug-shell (requires BUILDX_EXPERIMENTAL=1) #1296 #1620 #1614 #1737 #1755 docs
New monitor mode commands exec and attach to allow spawning additional processes in a debugging session (requires BUILDX_EXPERIMENTAL=1) #1626 docs
New experimental debug-shell command to directly start the build debugging monitor without starting a build, allowing connecting to previously --detached builds (requires BUILDX_EXPERIMENTAL=1) #1640 docs
New experimental --invoke=on-error option for the --invoke command to start the build debugging monitor at the point at which a build fails (requires BUILDX_EXPERIMENTAL=1) #1640 docs
Bake now supports detecting compose.yml/compose.yaml files in addition to docker-compose.yml/docker-compose.yaml #1752
Bake now supports new compose build keys dockerfile_inline and additional_contexts #1784
Bake now supports replace HCL function #1720
Initial support for CLI command completion, including: builder names, folder names for build commands and bake targets #1727
Builds support the new EXPERIMENTAL_BUILDKIT_SOURCE_POLICY environment variable to set the path to a source policy docs #1628
BuildKit versions are correctly displayed in buildx ls and buildx inspect for builders using the Docker driver #1552
Builders using the remote driver allow using TLS without proving its own key/cert (if BuildKit remote is configured to support it) #1693
Builders using the kubernetes driver allow automatically generating the node name if not provided #1673
Builders using the kubernetes driver support a new serviceaccount option, which will set the created pod's serviceAccountName #1597
Builders using the kubernetes driver support the proxy-url kubeconfig option docs #1780
Fix possible panic when no builders are available #1732
Fix docker-container driver hang on container panic #1772
Fix bake failure when remote bake file is accessed using SSH #1711 #1734
Fix bake failure when remote bake context is incorrectly resolved #1783
Fix opaque error messages on invalid edge-case git urls #1710 #1733
Fix race in printer so that logrus warning messages appear at the end of the build deterministically #1794
Fix connection leak for feature check on default docker driver #1776
Previous release can be found at v0.10.4
Welcome to the 0.10.4 release of buildx!
Please try out the release binaries and report any issues at https://github.com/docker/buildx/issues.
Note
Buildx v0.10 enables support for a minimal SLSA Provenance attestation, which requires support for OCI-compliant multi-platform images. This may introduce issues with registry and runtime support (e.g. Google Cloud Run and Lambda). You can optionally disable the default provenance attestation functionality using
--provenance=false.
BUILDX_NO_DEFAULT_ATTESTATIONS as alternative to --provenance false #1645BUILDX_GIT_CHECK_DIRTY opt-in #1650Welcome to the 0.10.3 release of buildx!
Please try out the release binaries and report any issues at https://github.com/docker/buildx/issues.
Note
Buildx v0.10 enables support for a minimal SLSA Provenance attestation, which requires support for OCI-compliant multi-platform images. This may introduce issues with registry and runtime support (e.g. Google Cloud Run and Lambda). You can optionally disable the default provenance attestation functionality using
--provenance=false.
Welcome to the 0.10.2 release of buildx!
Please try out the release binaries and report any issues at https://github.com/docker/buildx/issues.
Note
Buildx v0.10 enables support for a minimal SLSA Provenance attestation, which requires support for OCI-compliant multi-platform images. This may introduce issues with registry and runtime support (e.g. Google Cloud Run and Lambda). You can optionally disable the default provenance attestation functionality using
--provenance=false.
SOURCE_DATE_EPOCH environment variable #1564Welcome to the 0.10.1 release of buildx!
Please try out the release binaries and report any issues at https://github.com/docker/buildx/issues.
Note
Buildx v0.10 enables support for a minimal SLSA Provenance attestation, which requires support for OCI-compliant multi-platform images. This may introduce issues with registry and runtime support (e.g. Google Cloud Run and Lambda). You can optionally disable the default provenance attestation functionality using
--provenance=false.
vsc:source metadata #1548rm --all-inactive #1547imagetools inspect by lazily loading data #1546imagetools commands #1559Previous release can be found at v0.10.0
Welcome to the 0.10.0 release of buildx!
Please try out the release binaries and report any issues at https://github.com/docker/buildx/issues.
Note
Buildx v0.10 enables support for a minimal SLSA Provenance attestation, which requires support for OCI-compliant multi-platform images. This may introduce issues with registry and runtime support (e.g. Google Cloud Run and Lambda). You can optionally disable the default provenance attestation functionality using
--provenance=false.
Build command supports new flags --attest and shorthands --sbom and --provenance for adding attestations for your current build. --attest type=sbom or --sbom=true will generate SBOM (Software Bill of Materials) attestation for your build result in SPDX format. --attest type=provenance or --provenance=true will generate SLSA provenance attestation for your build result with information about how the build was performed. When creating OCI images a minimal provenance attestation is included with the image by default. This feature requires BuildKit v0.11.0+. Read more about advanced SBOM options from BuildKit docs. #1412 #1475
When building with BuildKit that supports provenance attestations Buildx will automatically share the version control information of your build context so it can be shown in provenance for later debugging. Previously this only happened when building from a Git URL directly. To opt-out of this behavior you can set BUILDX_GIT_INFO=0. Optionally you can also automatically define labels with VCS info by setting BUILDX_GIT_LABELS=1. #1462 #1297 #1341 #1468 #1477
Named contexts with --build-context now support oci-layout:// protocol for initializing the context with a value of a local OCI layout directory. E.g. --build-context stagename=oci-layout://path/to/dir. This feature requires BuildKit v0.11.0+ and Dockerfile 1.5.0+. #1456
Bake now supports resource interpolation where you can reuse the values from other target definitions. #1434
Buildx will now automatically forward SOURCE_DATE_EPOCH build-arg if one is defined in your environment. This feature is meant to be used with updated reproducible builds support in BuildKit v0.11.0+ #1482
Buildx will now remember the last activity for a builder for better organization of builder instances. #1439
Bake now supports null values for build arguments and label to use the defaults set in Dockerfile #1449
Imagetools inspect commands now supports showind SBOM and Provenance data #1444 #1498
Increase performance of buildx ls and inspect flows #1430 #1454 #1455 #1345
Adding extra hosts with Docker driver now supports Docker specific "host-gateway" special value #1446
OCI exporter now supports tar=false option for exporting OCI format directly in a directory #1420
Compose support has been updated to 1.6.0 #1387
--invoke can now load default launch environment from the image metadata #1324
Fix container driver behavior in regards to UserNS #1368
Fix possible panic in Bake when using wrong variable value type #1442
Fix possible panic in imagetools inspect #1441 #1406
Fix sending empty --add-host value to BuildKit by default #1457
Fix handling progress prefixes with progress groups #1305
Fix recursively resolving groups in Bake #1313
Fix possible wrong indentation on multi-node builder manifests #1396
Fix possible panic from missing OpenTelemetry configuration #1383
Fix --progress=tty behavior when TTY is not available #1371
Fix connection error conditions in prune and du commands #1307
Previous release can be found at v0.9.1
Welcome to the 0.10.0-rc3 release of buildx! This is a pre-release of buildx
Please try out the release binaries and report any issues at https://github.com/docker/buildx/issues.
Previous release can be found at v0.10.0-rc2
Welcome to the 0.10.0-rc2 release of buildx! This is a pre-release of buildx
Please try out the release binaries and report any issues at https://github.com/docker/buildx/issues.
Fix handling BUILDX_GIT_INFO environment variable #1468
All build options are now forwarded with the main build request as well as the frontend request #1476
Bake now supports null values for build arguments and label to use the defaults set in Dockerfile #1449
Duplicate attestations fields now produce an error https://github.com/docker/buildx/pull/1475
Reading current commit info from version control system has been updated. The performance on WSL2 has been increased https://github.com/docker/buildx/pull/1477
Release pipeline for Buildx now produces SBOM and Provenance artifacts #1472
Welcome to the 0.10.0-rc1 release of buildx! This is a pre-release of buildx
Please try out the release binaries and report any issues at https://github.com/docker/buildx/issues.
Build command supports new flags --attest and shorthands --sbom and --provenance for adding attestations for your current build. --attest type=sbom or --sbom=true will generate SBOM (Software Bill of Materials) attestation for your build result in SPDX format. --attest type=provenance or --provenance=true will generate SLSA provenance attestation for your build result with information about how the build was performed. When creating OCI images a minimal provenance attestation is included with the image by default. This feature requires BuildKit v0.11. Read more about advanced SBOM options from BuildKit docs. #1412
When building with BuildKit that supports provenance attestations Buildx will automatically share the version control information of your build context so it can be shown in provenance for later debugging. Previously this only happened when building from a Git URL directly. To opt-out of this behavior you can set BUILDX_GIT_INFO=0. Optionally you can also automatically define labels with VCS info by setting BUILDX_GIT_LABELS=1. #1462 #1297 #1341
Named contexts with --build-context now support oci-layout:// protocol for initializing the context with a value of a local OCI layout directory. E.g. --build-context stagename=oci-layout://path/to/dir@sha256:digest.
Bake now supports resource interpolation where you can reuse the values from other target definitions. #1434
Buildx will now remember the last activity for a builder for better organization of builder instances. #1439
Increase performance of buildx ls and inspect flows #1430 #1454 #1455 #1345
Adding extra hosts with Docker driver now supports Docker specific "host-gateway" special value #1446
OCI exporter now supports tar=false option for exporting OCI format directly in a directory #1420
Compose support has been updated to 1.6.0 #1387
--invoke can now load default launch environment from the image metadata #1324
Fix container driver behavior in regards to UserNS #1368
Fix possible panic in Bake when using wrong variable value type #1442
Fix possible panic in imagetools inspect #1441 #1406
Fix sending empty --add-host value to BuildKit by default #1457
Fix handling progress prefixes with progress groups #1305
Fix recursively resolving groups in Bake #1313
Fix possible wrong indentation on multi-node builder manifests #1396
Fix possible panic from missing OpenTelemetry configuration #1383
Fix --progress=tty behavior when TTY is not available #1371
Fix connection error conditions in prune and du commands #1307
Previous release can be found at v0.9.1
Welcome to the 0.9.0 release of buildx!
Please try out the release binaries and report any issues at https://github.com/docker/buildx/issues.
oci-layout:// for loading build context from local OCI layout directories. Note that this feature depends on an unreleased BuildKit feature and builder instance from moby/buildkit:master needs to be used until BuildKit v0.11 is released. #1173 docs--print flag can be used to run helper functions supported by the BuildKit frontend performing the build and print their results. In Dockerfile this feature can be used to show the build arguments and secrets that the current build supports with --print=outline and list all available Dockerfile stages with --print=targets. This feature is experimental for gathering early feedback and requires enabling BUILDX_EXPERIMENTAL=1 environment variable. We plan to update/extend this feature in the future without keeping backward compatibility. #1100 #1272--invoke flag can be used to launch interactive containers from build results for an iterative debugging cycle. These containers can then be reloaded with code changes or restored to intial state from special monitor mode. This feature is experimental for gathering early feedback and requires enabling BUILDX_EXPERIMENTAL=1 environment variable. We plan to update/extend this feature in the future without keeping backwards compatibility #1168 #1257 #1259 docsBUILDKIT_COLORS and NO_COLOR to customize/disable the colors of interactive build progressbar #1230 #1226 docsbuildx create command now does additional validation of builder parameters to avoid creating a builder instance with invalid configuration #1206buildx imagetools create command can now create new multi-platform images even if the source subimages are located on different repositories or registries #1137--config value #1111buildx ls command now shows the current BuildKit version of each builder instance #998buildx ls command output has been updated with better access to errors from different builders #1109dockerd instance supports initially disabled Buildkit features like multi-platform images #1260 #1262.env file automatically when building Compose files for compatibility #1261cache_to definition #1155timestamp() to access current time #1214x-bake #1256. in the name are now converter to use _ so the selector keys can still be used in such targets #1011prune command #1252--builder flag correctly #1067