You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
37 lines
1.8 KiB
Markdown
37 lines
1.8 KiB
Markdown
# High-level build options with Bake
|
|
|
|
> This command is experimental.
|
|
>
|
|
> The design of bake is in early stages, and we are looking for [feedback from users](https://github.com/docker/buildx/issues).
|
|
{: .experimental }
|
|
|
|
Buildx also aims to provide support for high-level build concepts that go beyond
|
|
invoking a single build command. We want to support building all the images in
|
|
your application together and let the users define project specific reusable
|
|
build flows that can then be easily invoked by anyone.
|
|
|
|
[BuildKit](https://github.com/moby/buildkit) efficiently handles multiple
|
|
concurrent build requests and de-duplicating work. The build commands can be
|
|
combined with general-purpose command runners (for example, `make`). However,
|
|
these tools generally invoke builds in sequence and therefore cannot leverage
|
|
the full potential of BuildKit parallelization, or combine BuildKit's output
|
|
for the user. For this use case, we have added a command called
|
|
[`docker buildx bake`](https://docs.docker.com/engine/reference/commandline/buildx_bake/).
|
|
|
|
The `bake` command supports building images from HCL, JSON and Compose files.
|
|
This is similar to [`docker compose build`](https://docs.docker.com/compose/reference/build/),
|
|
but allowing all the services to be built concurrently as part of a single
|
|
request. If multiple files are specified they are all read and configurations are
|
|
combined.
|
|
|
|
We recommend using HCL files as its experience is more aligned with buildx UX
|
|
and also allows better code reuse, different target groups and extended features.
|
|
|
|
## Next steps
|
|
|
|
* [File definition](file-definition.md)
|
|
* [Configuring builds](configuring-build.md)
|
|
* [User defined HCL functions](hcl-funcs.md)
|
|
* [Defining additional build contexts and linking targets](build-contexts.md)
|
|
* [Building from Compose file](compose-file.md)
|