opschain admin agent rollover abort
packs:agentspacks:agent-governance
opschain admin agent rollover abort <agent> [--lane <lane>] [--reason <text>] [--server <url>] [--auth-token <token>]
Return the canaries to the source release and close the rollover (v2 AgentService.AdvanceAgentRollover, action abort).
Applies to a canary rollover before continue (holding, or still
rolling its canaries): the canaries are drained and instructed to restart
from the source release, instances still on the source release are
un-drained so the lane keeps serving, and the rollover closes as
aborted once the last canary re-enrols. Lands
info:agent:rollover_aborted. After continue, use rollback instead.
Under blue-green it closes a rollover before its flip (rolling
or green_ready): nothing moves, dispatch stayed on the serving lane,
and the green lane keeps whatever instances came up — stop them, or roll
over again and they count toward the green lane at once.
Every step is attested on the release (opschain admin agent-release show) under the rollover's one correlation chain. <agent> is the
agent's member id, <project>/<code>, or a bare code when exactly one
project holds it; --lane names the lane whose open rollover the verb
applies to.
Flags
| Flag | Meaning |
|---|---|
--lane <lane> | The lane whose open rollover the verb applies to (default stable). |
--reason <text> | Audited reason. |
--server <url> | Server base URL. Default: the active context, then OPSCHAIN_SERVER. |
--auth-token <token> | Admin bearer token override. Default: your opschain login session, then $OPSCHAIN_ADMIN_TOKEN, then the token stored by opschain admin login for that server. |
Output
rollover 01a1aecc-… of limebank/felix lane stable: aborting (felix@2.0.0 → felix@2.1.0)
-o json|yaml prints the rollover document; the status becomes
aborting, then aborted.
Exit codes
| Code | Meaning |
|---|---|
| 0 | The verb applied. |
| 1 | The server refused it: no rollover is open on the lane, or the rollover is not in a state the verb applies to (the message names the state). |
| 2 | Usage — wrong arguments, or no server / admin token resolvable. |
See also
opschain docs cli/admin-agent-rollover— the rollover verb and its strategies.