autonomy ha failover trigger

Trigger a manual failover (graceful leader resignation)

Synopsis

Instructs the current control-plane leader to gracefully resign, releasing the advisory lock and closing the current epoch.

A standby node running Campaign() will then acquire leadership and establish a new epoch. This is the manual failover path for planned maintenance or operator-initiated recovery.

Preconditions:

  • The target node must be the current leader

  • Replication lag must not be critical (safety check)

Use ‘autonomy ha status’ to verify cluster state before and after triggering a failover.

Usage

autonomy ha failover trigger [flags]

Options

      --operator string           operator identity for audit trail (required)
      --orchestrator-url string   orchestrator base URL (env: AUTONOMY_ORCHESTRATOR_URL)
      --output string             output format: "text" (human-readable) or "json" (machine-readable) (default "text")
      --reason string             reason for the failover (for audit trail)

See also