Skip to content

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.

wheels deploy build create [--destination=<name>] [--dry-run]

| Flag | Description | |------|-------------| | --destination=<name> | Overlay destination config. | | --dry-run | Print the commands without executing. |

  • 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 createdocker build alone suffices.

Emits docker buildx create --use ... with a name derived from the service. Idempotent — re-running uses the existing builder.

Example
wheels deploy build create