Using Docker Buildx Bake for Efficient Multi‑Platform Image Builds

With the widespread adoption of containerization, building and managing multi‑platform images has become increasingly important. Docker Buildx is an official Docker CLI extension that provides stronger and more flexible build capabilities.

Multi‑platform builds: Build images for multiple CPU architectures (e.g., x86, ARM) in a single command.

Build cache optimization: Improves caching by automatically detecting cacheable Dockerfile sections, reducing redundant builds.

Parallel builds: Allows concurrent building of multiple images to increase efficiency.

Multiple output formats: Supports Docker images, OCI images, and rootfs outputs.

Build strategies: Enables advanced control such as remote or distributed builds across nodes.

Using docker buildx requires Docker Engine version 19.03 or higher.

This article focuses on Docker Buildx Bake, a sub‑command of Buildx, covering its concepts, benefits, usage scenarios, and how it can accelerate multi‑platform image construction and management.

What is Docker Buildx Bake?

Docker Buildx Bake is a feature of Docker Buildx that simplifies and speeds up image building. Bake provides a declarative way to define multiple build configurations and target platforms in a single command, enabling automated batch builds and cross‑platform image publishing.

Why use Docker Buildx Bake?

1. Improve build efficiency

Bake leverages parallel builds and caching to boost efficiency. It allows defining and building multiple images at once, saving time and increasing productivity.

2. Support multiple platforms and architectures

By specifying platform parameters in the Bake configuration, you can easily build images for different operating systems and architectures, which is valuable for cross‑platform applications.

3. Consistent build environment

Describing the build process in a docker-bake.hcl (or JSON/YAML) file ensures a consistent environment across different configurations and target platforms, reducing errors and simplifying maintenance.

How to use Docker Buildx Bake?

First, ensure Docker Engine or Docker Desktop version 19.03+ is installed. The basic command becomes:

docker buildx bake or docker buildx bake --help for usage information.

docker buildx bake --help

Usage:  docker buildx bake [OPTIONS] [TARGET...]

Build from a file

Aliases:
  docker buildx bake, docker buildx f

Options:
      --builder string          Override the configured builder instance
  -f, --file stringArray        Build definition file
      --load                    Shorthand for "--set=*.output=type=docker"
      --metadata-file string    Write build result metadata to the file
      --no-cache                Do not use cache when building the image
      --print                   Print the options without building
      --progress string         Set type of progress output ("auto", "plain", "tty")
      --provenance string       Shorthand for "--set=*.attest=type=provenance"
      --pull                    Always attempt to pull all referenced images
      --push                    Shorthand for "--set=*.output=type=registry"
      --sbom string             Shorthand for "--set=*.attest=type=sbom"
      --set stringArray         Override target value (e.g., "targetpattern.key=value")

1. Create a Bake configuration file

For example, create docker-bake.dev.hcl with the following content:

# docker-bake.dev.hcl
group "default" {
  targets = ["db", "webapp-dev"]
}

target "db" {
  dockerfile = "Dockerfile.db"
  tags = ["xianpengshen/docker-buildx-bake-demo:db"]
}

target "webapp-dev" {
  dockerfile = "Dockerfile.webapp"
  tags = ["xianpengshen/docker-buildx-bake-demo:webapp"]
}

target "webapp-release" {
  inherits = ["webapp-dev"]
  platforms = ["linux/amd64", "linux/arm64"]
}

2. Run Bake to build images

Execute the following command:

$ docker buildx bake -f docker-bake.dev.hcl db webapp-release

3. Print build options without building

Use the --print flag to view the resolved build configuration:

$ docker buildx bake -f docker-bake.dev.hcl --print db
[+] Building 0.0s (0/0)
{
  "group": {
    "default": {
      "targets": ["db"]
    }
  },
  "target": {
    "db": {
      "context": ".",
      "dockerfile": "Dockerfile.db",
      "tags": ["xianpengshen/docker-buildx-bake-demo:db"]
    }
  }
}

4. Publish built images

Add the --push option to push the images to a registry in one step:

$ docker buildx bake -f docker-bake.dev.hcl --push db webapp-release

The demo repository is available at https://github.com/shenxianpeng/docker-buildx-bake-demo .

5. Advanced Bake usage

Additional techniques such as variables, functions, and matrix builds are supported; refer to the official Buildx Bake reference for details.

Conclusion

Docker Buildx Bake is a powerful tool that simplifies and accelerates the container image build process. By using Bake, developers and build engineers can efficiently construct and test multiple images across various platforms and architectures, helping to speed up application delivery.