Skip to content

Command Line Tools

wheels deploy build push

Build the image locally and push it to the configured registry. Runs on the control machine; no SSH, no remote hosts.

wheels deploy build push [--version=<v>] [--destination=<name>] [--dry-run]
FlagDescription
--version=<v>Tag for the pushed image. Defaults to git short sha.
--destination=<name>Overlay destination config.
--dry-runPrint the docker build + docker push commands without executing.

Uses the builder: block in deploy.yml:

  1. docker build with context, dockerfile, args, and arch from config.
  2. docker push <image>:<version>.

If builder.remote: is set, the build happens on the remote builder over SSH instead of locally. Multi-arch builds require docker buildx (run build create once).

example
wheels deploy build push