akua / cli / deploy

akua deploy

Planned

Deploy rendered output to a reconciler target.

akua deploy [path] [flags]

Depending on --to=<target>:

--to=argo — render, open a PR against the deploy repo, Argo picks up
--to=flux — same with Flux
--to=kro — deploy the RGD output to kro
--to=helm — helm upgrade --install
--to=kubectl — kubectl apply directly
--to=<custom-driver> — configured driver

Subcommands

akua deploy status   --handle=<h>
akua deploy wait     --handle=<h> [--timeout=<d>]
akua deploy rollback --change=<id>
akua deploy history  [--service=<name>] [--last=<n>]
akua deploy cancel   --handle=<h>

JSON output (main verb)

{
  "handle": "r-4f2c9a",
  "target": "argo",
  "status": "pending",
  "resources_planned": 12,
  "pr_url": "https://github.com/acme/deploy-repo/pull/48",
  "policy": { "verdict": "allow" }
}

JSON output (status)

{
  "handle": "r-4f2c9a",
  "phase": "reconciling",
  "health": "degraded",
  "ready": 2,
  "total": 3,
  "started_at": "2026-04-20T14:03:00Z",
  "last_event": "Deployment/api: 2/3 replicas ready"
}