buildx bake adoption --push

First use of buildx bake in your workflow.

What is Docker buildx?

• New builder as CLI plugin available since Docker 19.03
• docker buildx build <> docker build
• But with many new features
  • Scoped builder instances
  • Building against multiple nodes concurrently
  • External cache source for your build
  • Building multi-platform images
  • Full BuildKit capabilities with container driver
  • High-level build command with bake

A buildx command in the wild

• docker buildx build \
  • --push \
  • --cache-from "type=registry,ref=foo/myapp" \
  • --cache-to "type=inline" \
  • --platform "linux/amd64,linux/arm/v6,linux/arm/v7,linux/arm64" \
  • --label "org.opencontainers.image.title=myapp" \
  • --label "org.opencontainers.image.source=https://github.com/foo/myapp" \
  • --label "org.opencontainers.image.version=1.0.0" \
  • --label "org.opencontainers.image.licenses=Apache-2.0" \
  • --tag "foo/myapp:v1.0.0" \
  • --tag "foo/myapp:latest" \
  • --file "./main.Dockerfile" \
  • .

With bake

• docker buildx bake \
  • --push
  • --cache-from "type=registry,ref=foo/myapp" \
  • --cache-to "type=inline" \
  • --platform "linux/amd64,linux/arm/v6,linux/arm/v7,linux/arm64" \
  • --label "org.opencontainers.image.title=myapp" \
  • --label "org.opencontainers.image.source=https://github.com/foo/myapp" \
  • --tag "foo/myapp:v1.0.0" \
  • --tag "foo/myapp:latest" \
  • --file "./main.Dockerfile" \
  • .

bake definition

• Can be a Docker Compose, JSON or HCL file
• Multiple files can be specified with --file flag
  • Configurations are merged
• Default to
  • Compose: docker-compose.yml, docker-compose.yaml
  • JSON: docker-bake.json, docker-bake.override.json
  • HCL: docker-bake.hcl, docker-bake.override.hcl

HCL format

docker buildx bake image-all

group "default" {
  targets = ["image"]
}

variable "TAG" {
  default = "v0.0.0"
}

target "tag" {
  tags = ["foo/myapp:${TAG}"]
}

target "image" {
  inherits = ["tag"]
  context = "."
  dockerfile = "./main.Dockerfile"
  cache-from = ["type=registry,ref=foo/myapp"]
  cache-to = ["type=inline"]
  labels = {
    "org.opencontainers.image.title" = "myapp"
    "org.opencontainers.image.ref" = "https://github.com/foo/myapp"
  }
  tags = [
    "foo/myapp:latest"
  ]
}

target "image-all" {
  inherits = ["image"]
  platforms = [ "linux/amd64", "linux/arm/v6", "linux/arm/v7", "linux/arm64" ]
}

Thanks for your time!

• Slides and demo available on GitHub
• Bake is still experimental but please give us your feedback if you want to use it!
• A GitHub Action is already available: https://github.com/docker/bake-action
• Check out Diun project as a complete example of using bake