Command Line Tools
wheels deploy build create
Create a docker buildx builder on the control machine. One-time setup for multi-arch builds and remote builds.
Synopsis
Section titled “Synopsis”wheels deploy build create [--destination=<name>] [--dry-run]| Flag | Description |
|---|---|
--destination=<name> | Overlay destination config. |
--dry-run | Print the commands without executing. |
When to run
Section titled “When to run”- Before the first multi-arch build (
builder.arch:has more than one entry). - Before the first build against a remote builder (
builder.remote:is set). - Single-arch local builds don’t need
build create—docker buildalone suffices.
Behavior
Section titled “Behavior”Emits docker buildx create --use ... with a name derived from the service. Idempotent — re-running uses the existing builder.
Example
Section titled “Example”wheels deploy build create