liveBook · Manning

Build node

As explained in Learn Docker in a Month of Lunches, Second Edition

A build node is a Docker Engine endpoint assigned to perform image-building work in a Buildx builder.

A build node is a Docker Engine endpoint assigned to build one or more image platforms within a Buildx builder. Nodes may use emulation or native hardware. section 12.4

Configure a multi-node builder by:

  • Creating a Docker context for each Docker Engine endpoint. section 12.4
  • Creating a Buildx builder with one platform-specific node, then appending another node. section 12.4
  • Building concurrently across nodes and pushing platform variants with a combined manifest list. section 12.4

Two-node Linux builder

Create a builder for linux/amd64, append a linux/arm64 node using another context, then run `docker buildx build --platform linux/arm64,linux/amd64 --push` to publish both variants. section 12.4

# create the builder – this adds a node with the current context:
docker buildx create --name ch12-builder --platform linux/amd64
# append a second node using the duplicate context:
docker buildx create --append --name ch12-builder `
 --platform linux/arm64 ch12-context
# list your builders:
docker buildx ls

Use the command listing to create the first Buildx node, append a second platform-specific node, and inspect the builder. section 12.4

How Learn Docker in a Month of Lunches, Second Edition covers it

How deep it goes
Explains contexts, node assignment, concurrent builds, emulation, and manifest publishing without detailing Buildx internals.
Examples
Uses duplicate Docker contexts, linux/amd64 and linux/arm64 nodes, and a pushed sample application image.
What it assumes
Assumes Docker contexts and Buildx commands, while demonstrating the required context duplication and builder-node setup.
What you can do after
Operate/configure Docker Buildx to create nodes, assemble a builder, and push multi-platform images.
How it connects
Connects build nodes with Docker contexts, Buildx builders, emulation, Dockerfiles, registries, and multi-platform images.

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Learn Docker in a Month of Lunches, Second Edition. The section links point to the parts of the book it draws on.