Build release notes

Estimated reading time: 20 minutes

This page contains information about the new features, improvements, and bug fixes in Docker Buildx.

0.9.1

2022-08-18

Enhancements

Fixes

  • Fixed a regression when building Compose files that contain services without a build block docker/buildx#1277

For more details, see the complete release notes in the Buildx GitHub repository.

0.9.0

2022-08-17

New features

  • Support for new driver remote that you can use to connect to any already running BuildKit instance docker/buildx#1078 docker/buildx#1093 docker/buildx#1094 docker/buildx#1103 docker/buildx#1134 docker/buildx#1204
  • You can now load Dockerfile from standard input even when the build context is coming from external Git or HTTP URL docker/buildx#994
  • Build commands now support new the build context type 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 docker/buildx#1173
  • You can now use the new --print flag to run helper functions supported by the BuildKit frontend performing the build and print their results. You can use this feature in Dockerfile 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 docker/buildx#1100 docker/buildx#1272
  • You can now use the new --invoke flag to launch interactive containers from build results for an interactive debugging cycle. You can reload these containers with code changes or restore them to an initial state from the 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 enabling backward compatibility docker/buildx#1168 docker/buildx#1257 docker/buildx#1259
  • Buildx now understands environment variable BUILDKIT_COLORS and NO_COLOR to customize/disable the colors of interactive build progressbar docker/buildx#1230 docker/buildx#1226
  • buildx ls command now shows the current BuildKit version of each builder instance docker/buildx#998
  • The bake command now loads .env file automatically when building Compose files for compatibility docker/buildx#1261
  • Bake now supports Compose files with cache_to definition docker/buildx#1155
  • Bake now supports new builtin function timestamp() to access current time docker/buildx#1214
  • Bake now supports Compose build secrets definition docker/buildx#1069
  • Additional build context configuration is now supported in Compose files via x-bake docker/buildx#1256
  • Inspecting builder now shows current driver options configuration docker/buildx#1003 docker/buildx#1066

Enhancements

  • The buildx create command now perfoms additional validation of builder parameters to avoid creating a builder instance with invalid configuration docker/buildx#1206
  • The buildx imagetools create command can now create new multi-platform images even if the source subimages are located on different repositories or registries docker/buildx#1137
  • You can now set the default builder config that is used when creating builder instances without passing custom --config value docker/buildx#1111
  • The buildx ls command output has been updated with better access to errors from different builders docker/buildx#1109
  • Docker driver can now detect if dockerd instance supports initially disabled Buildkit features like multi-platform images docker/buildx#1260 docker/buildx#1262
  • Compose files using targets with . in the name are now converted to use _ so the selector keys can still be used in such targets docker/buildx#1011
  • Updated the Compose Specification to 1.4.0 docker/buildx#1246 docker/buildx#1251
  • Included an additional validation for checking valid driver configurations docker/buildx#1188 docker/buildx#1273
  • The remove command now displays the removed builder and forbids removing context builders docker/buildx#1128
  • Enable Azure authentication when using Kubernetes driver docker/buildx#974
  • Add tolerations handling for kubernetes driver docker/buildx#1045 docker/buildx#1053
  • Replace deprecated seccomp annotations with securityContext in kubernetes driver docker/buildx#1052

Fixes

For more details, see the complete release notes in the Buildx GitHub repository.

0.8.2

2022-04-04

Fixes

  • Update Compose spec used by buildx bake to v1.2.1 to fix parsing ports definition docker/buildx#1033
  • Fix possible crash on handling progress streams from BuildKit v0.10 docker/buildx#1042
  • Fix parsing groups in buildx bake when already loaded by a parent group docker/buildx#1021

For more details, see the complete release notes in the Buildx GitHub repository.

0.8.1

2022-03-21

Fixes

Enhancements

  • Allow . on Compose target names in buildx bake for backward compatibility docker/buildx#1018

For more details, see the complete release notes in the Buildx GitHub repository.

0.8.0

2022-03-09

New features

Enhancements

  • --metadata-file output now supports embedded structure types docker/buildx#946
  • buildx rm now accepts new flag --all-inactive for removing all builders that are not currently running docker/buildx#885
  • Proxy config is now read from Docker configuration file and sent with build requests for backward compatibility docker/buildx#959
  • Support host networking in Compose docker/buildx#905 docker/buildx#880
  • Bake files can now be read from stdin with -f - docker/buildx#864
  • --iidfile now always writes the image config digest independently of the driver being used (use --metadata-file for digest) docker/buildx#980
  • Target names in Bake are now restricted to not use special characters docker/buildx#929
  • Image manifest digest can be read from metadata when pushed with docker driver docker/buildx#989

Fixes

For more details, see the complete release notes in the Buildx GitHub repository.

0.7.1

2021-08-25

Fixes

For more details, see the complete release notes in the Buildx GitHub repository.

0.7.0

2021-11-10

New features

Enhancements

  • Allow using custom registry configuration for multi-node pushes from the client docker/buildx#825
  • Allow using custom registry configuration for buildx imagetools command docker/buildx#825
  • Allow booting builder after creating with buildx create --bootstrap docker/buildx#692
  • Allow registry:insecure output option for multi-node pushes docker/buildx#825
  • BuildKit config and TLS files are now kept in Buildx state directory and reused if BuildKit instance needs to be recreated docker/buildx#824
  • Ensure different projects use separate destination directories for incremental context transfer for better performance docker/buildx#817
  • Build containers are now placed on separate cgroup by default docker/buildx#782
  • Bake now prints the default group with --print docker/buildx#720
  • docker driver now dials build session over HTTP for better performance docker/buildx#804

Fixes

For more details, see the complete release notes in the Buildx GitHub repository.

0.6.3

2021-08-30

Fixes

For more details, see the complete release notes in the Buildx GitHub repository.

0.6.2

2021-08-21

For more details, see the complete release notes in the Buildx GitHub repository.

Fixes

0.6.1

2021-07-30

Enhancements

Fixes

For more details, see the complete release notes in the Buildx GitHub repository.

0.6.0

2021-07-16

New features

Enhancements

Fixes

  • imagetools create command now correctly merges JSON descriptor with old one docker/buildx#592
  • Fix building with --network=none not requiring extra security entitlements docker/buildx#531

For more details, see the complete release notes in the Buildx GitHub repository.

0.5.1

2020-12-15

Fixes

  • Fix regression on setting --platform on buildx create outside kubernetes driver docker/buildx#475

For more details, see the complete release notes in the Buildx GitHub repository.

0.5.0

2020-12-15

New features

  • The docker driver now supports the --push flag docker/buildx#442
  • Bake supports inline Dockerfiles docker/buildx#398
  • Bake supports building from remote URLs and Git repositories docker/buildx#398
  • BUILDX_CONFIG env var allow users to have separate buildx state from Docker config docker/buildx#385
  • BUILDKIT_MULTI_PLATFORM build arg allows to force building multi-platform return objects even if only one --platform specified docker/buildx#467

Enhancements

Fixes

  • Handle lowercase Dockerfile name as a fallback for backward compatibility docker/buildx#444

For more details, see the complete release notes in the Buildx GitHub repository.

0.4.2

2020-08-22

New features

Enhancements

Fixes

For more details, see the complete release notes in the Buildx GitHub repository.

0.4.1

2020-05-01

Fixes

For more details, see the complete release notes in the Buildx GitHub repository.

0.4.0

2020-04-30

New features

Enhancements

For more details, see the complete release notes in the Buildx GitHub repository.

0.3.1

2019-09-27

Enhancements

Fixes

For more details, see the complete release notes in the Buildx GitHub repository.

0.3.0

2019-08-02

New features

Enhancements

Fixes

  • Fix bug where --build-arg foo would not read foo from environment docker/buildx#116

For more details, see the complete release notes in the Buildx GitHub repository.

0.2.2

2019-05-30

Enhancements

  • Change Compose file handling to require valid service specifications docker/buildx#87

For more details, see the complete release notes in the Buildx GitHub repository.

0.2.1

2019-05-25

New features

Enhancements

Fixes

For more details, see the complete release notes in the Buildx GitHub repository.

0.2.0

2019-04-25

New features

  • First release

For more details, see the complete release notes in the Buildx GitHub repository.

build, buildx, buildkit, release notes