MAQPNADocs

maqpna rollout

Manage the rollout of agents: status, history, restart (kubectl rollout)

Run agents-o json | yaml

Synopsis#

maqpna rollout status ag/NAME | agent NAME [-n NS] [--watch=true|false] [--timeout 5m]
maqpna rollout history ag/NAME [-n NS]
maqpna rollout restart ag/NAME [-n NS] [--yes]

Description#

Agents keep no revision history and run no ReplicaSet. status waits until the operator has observed the Agent's current generation and reports it Ready. history prints that generation (and the kubernetes.io/change-cause annotation). restart stamps maqpna.com/restartedAt on the Agent and restarts the sandbox pods of its running sessions (the sandbox controller re-creates them; in-memory agent state is lost), so it asks first. undo, pause and resume do not apply: change the Agent with apply/edit, or suspend sessions with maqpna session suspend.

Subcommands#

Examples#

maqpna rollout status ag/coder -n team-a
maqpna rollout restart agent coder -n team-a --yes

What happens when you run it#

  • Prints a table by default; -o json or -o yaml print the data, and --jq EXPR filters the JSON.

Exit codes#

CodeMeaning
0success
1error (the message says what failed, with a hint when there is one)
2usage error: unknown flag, missing argument or bad value; the synopsis is printed
3a check failed, a change is blocked, or a result did not match (tamper, policy mismatch) (not used by this command)