Skip to content

Add aos-unitctl CLI for node lifecycle + console/log UX #2

Description

@klogg

Goal

Provide a simple operator CLI that wraps common systemctl/journalctl/socat workflows.

Commands (initial)

  • aos-unitctl status (overall service + list nodes)
  • aos-unitctl list (nodes + unit names + IP/MAC if available)
  • aos-unitctl start|stop|restart <node>
  • aos-unitctl console <node> (socat attach to /run/aos-unit/<node>.serial)
  • aos-unitctl logs <node> (journal + serial/debug file pointers)
  • aos-unitctl validate-config (run parser + sanity checks without starting VMs)

Notes

  • Should be safe-by-default: no arbitrary passthrough to QEMU.
  • Prefer explicit mapping node -> unit (aos-node-<node>.service) and known socket paths.

Acceptance criteria

  • No new security surface (no “extra QEMU args” passthrough).
  • Clear error messages and exit codes suitable for automation.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions