canasta upgrade

Upgrade Canasta instances

Synopsis

Upgrade all registered Canasta instances by refreshing configs, pulling latest images, running migrations, and restarting containers.

By default the CLI itself updates to the latest released version within the current major (the highest vX.Y.Z tag whose major matches the installed version), so an upgrade never crosses a major boundary on its own. Pass --allow-major to move to the latest release overall, including a new major version (which may include breaking changes). Pass --dev to track the development branch (head of main) instead.

Pass --purge to reclaim disk after the upgrade: each upgraded host has the Canasta images the upgrade superseded removed (only those no container or pod still references), dangling sidecar-rebuild layers pruned, and — on Kubernetes — the in-cluster registry garbage-collected. Volumes are never touched.

canasta upgrade [flags]

Examples

canasta upgrade
canasta upgrade --allow-major
canasta upgrade --dev
canasta upgrade --dry-run
canasta upgrade --purge

Flags

Flag	Description	Orchestrator
`--allow-major`	Allow upgrading across a major version boundary to the latest release overall (may include breaking changes)	Both
`--dev`	Track the development branch (head of main) instead of the latest release	Both
`--dry-run`	Preview changes without applying	Both
`--purge`	After upgrading, reclaim disk by removing images the upgrade superseded (never removes in-use images or volumes)	Both

Global flags

Flag	Shorthand	Description	Default	Required	Orchestrator
`--help`	`-h`	Show help message and exit			Both
`--verbose`	`-v`	Enable verbose output			Both