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 |
--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 latest deployment for a branch reaches a terminal state.
yofix watchyofix watch --branch main --timeout 900 --interval 10| Flag | Default | Description |
|---|---|---|
--branch <branch> | current git branch | Branch to watch |
--timeout <seconds> | 600 | Give up after this many seconds |
--interval <seconds> | 5 | Poll interval |
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 terminal deployment from the same commit.
yofix redeploy <deploymentId>yofix deployments redeploy <deploymentId>yofix redeploy dpl_4f2a9c --cache| Flag | Default | Description |
|---|---|---|
--cache | fresh build | Reuse the build cache |
--prod | n/a | Accepted for parity; the rebuild inherits the source target (no-op) |
yofix cancel
Cancel an in-progress deployment.
yofix cancel <deploymentId>yofix deployments cancel <deploymentId>