Documentation
¶
Overview ¶
Command levelrail-agent is TASKS.md 3.2's node agent binary (the repo layout names it, this is the first pass to actually build it). Dials out to the control plane (ADR 003, never accepts an inbound connection), enrolls once using a one-time join token, persists the resulting identity, then holds one persistent Session open for as long as it runs, serving every incoming request against this node's own local Docker daemon (internal/docker, the exact "never shell the CLI" invariant the control plane's own Docker access already follows).
This binary is a thin main(): every real behavior (enrollment, the Session loop, request dispatch against docker.Runtime) lives in internal/agent, already tested there without a real process or network connection. What's here is env/flag parsing, identity file persistence, and the reconnect loop ADR 003's Consequences section calls out as real, standing Phase 3 work.
Source Files