wheels deploy app

App container lifecycle. Every verb targets containers labelled with the current service, optionally filtered by --role.

Verbs

Verb	Purpose
boot	docker run new containers for the given version.
start	docker start existing stopped containers.
stop	docker stop running containers.
details	docker inspect for the given version’s containers.
containers	docker ps filtered by service label.
images	docker images for the app image.
logs	docker logs across every host.
live	Clear the maintenance marker file.
maintenance	Write the maintenance marker file.
remove	Stop + remove containers for the given version.

Common flags

Flag	Description
--release=<v>	Required for boot/start/stop/details/live/maintenance/remove.
--role=<name>	Limit to one role. Default: all roles.
--destination=<name>	Overlay destination config.
--dry-run	Print commands without executing.

--release, not --version

The version always travels as --release=. A literal --version= flag never reaches deploy dispatch — the CLI’s picocli root intercepts it first and fails with Invalid value for option '--version' (#2674).

Purely numeric release values

A purely numeric release value (e.g. --release=1) currently hangs for ~75 seconds with Operation timed out, even under --dry-run (#3111). Use a non-numeric label — a git short sha or a v-prefixed tag like v1.2.3 — until that’s fixed.