Deployments
Commands that create, inspect, and manage deployments. For the workflow, see Deploy from your machine.
The lifecycle verbs (promote, rollback, redeploy, cancel) are
available both as top-level commands and under yofix deployments <verb>;
they are identical.
yofix deploy
Deploy the current directory. Uploads the source, so no git push is
needed. Defaults to a preview; --prod ships to production. Blocks until
the build finishes unless --no-wait is set.
yofix deployyofix deploy --prodyofix deploy --no-wait --timeout 900| Flag | Default | Description |
|---|---|---|
--prod | preview | Deploy to production |
-m, --message <message> | commit message | Deploy message to record |
--branch <branch> | current git branch | Branch label to record |
--no-wait | waits | Return as soon as the build is queued |
--timeout <seconds> | 600 | Give up waiting after this many seconds |
yofix ls
List recent deployments. Alias of yofix deployments list.
yofix lsyofix ls --prod --limit 10yofix ls --status ready --branch main| Flag | Default | Description |
|---|---|---|
--status <status> | all | Filter by deployment status |
--branch <branch> | all | Filter by git branch |
--commit <sha> | all | Filter by git commit SHA |
--target <target> | all | Filter by target (preview, production) |
--prod | off | Shorthand for --target=production |
--limit <n> | 20 | Maximum rows to return |
yofix deployments get
Show full detail for a single deployment.
yofix deployments get <deploymentId>yofix inspect
Show deployment detail, optionally waiting for it to finish and printing logs.
yofix inspect <deploymentId>yofix inspect dpl_4f2a9c --wait --logs| Flag | Default | Description |
|---|---|---|
--wait | off | Block until the deployment reaches a terminal state |
--logs | off | Also print build logs after the detail |
--timeout <seconds> | 600 | Give up waiting after this many seconds |
--interval <seconds> | 5 | Poll interval when waiting |
yofix logs
Show or follow deployment logs. The deployment ID defaults to the most recent.
yofix logsyofix logs dpl_4f2a9c --followyofix logs --source build --since 15m --level error| Flag | Default | Description |
|---|---|---|
-f, --follow | off | Stream logs over WebSocket until the build ends or Ctrl-C |
--source <source> | all | Filter by source (build, vrt, runtime) |
--since <duration> | all | Only show logs newer than this (e.g. 1h, 15m) |
--level <level> | all | Minimum log level (info, warn, error) |
--limit <n> | 500 | Max lines for non-follow mode |
yofix watch
Block until the matching deployment reaches a terminal state.
yofix watchyofix watch --branch main --timeout 900 --interval 10yofix watch --commit $GITHUB_SHA --prod| Flag | Default | Description |
|---|---|---|
--branch <branch> | current git branch | Branch to watch |
--commit <sha> | latest on the branch | Watch the deployment for this exact commit |
--target <target> | any | Only watch deployments for this target (preview, production) |
--prod | off | Shorthand for --target=production |
--timeout <seconds> | 600 | Give up after this many seconds |
--interval <seconds> | 5 | Poll interval |
Gate a production promotion on --prod. One push can produce several
deployments for the same commit, typically a production build plus a
preview row that is immediately skipped (a [skip ci] commit, for
instance). A skipped deployment counts as finished, so watching without a
target can match the skipped preview and report success while production is
still building.
In CI, prefer --commit. Watching a branch follows whatever built most
recently on it, so a second push landing mid-workflow will silently redirect
the watch to the newer build. --commit pins the deployment for the exact SHA
the workflow checked out, and works on a detached HEAD where there is no branch
to infer.
yofix promote
Promote a deployment to production. This rebuilds the same commit with production environment variables. See Promote and rollback.
yofix promote <deploymentId>yofix deployments promote <deploymentId>yofix rollback
Roll production back to a previous deployment. This is an instant alias swap, not a rebuild.
yofix rollback <deploymentId>yofix deployments rollback <deploymentId>yofix redeploy
Rebuild a finished deployment from the same commit: ready, failed,
cancelled, skipped, or expired. An expired deployment’s files were removed
after its retention period; redeploying builds fresh files. The rebuild
keeps the source deployment’s target: a preview rebuild takes its branch
URL again, and a production rebuild that a newer build has replaced gets
its own URL until --live or yofix rollback makes it live. Deployments
uploaded with yofix deploy cannot be redeployed; run yofix deploy
again instead.
yofix redeploy <deploymentId>yofix deployments redeploy <deploymentId>yofix redeploy dpl_4f2a9c --cacheyofix redeploy dpl_4f2a9c --live| Flag | Default | Description |
|---|---|---|
--cache | fresh build | Reuse the build cache |
--live | server decides | Make the rebuild the live deployment for its target when it is ready. Without it, a rebuild of a production build that a newer one replaced only gets its own URL (use yofix rollback to make it live); rebuilding the live build replaces it |
yofix cancel
Cancel an in-progress deployment.
yofix cancel <deploymentId>yofix deployments cancel <deploymentId>