yuneta_agent

The primary agent — the supervisor of a Yuneta node. It manages the lifecycle of every other yuno (create / run / kill / update / delete), owns the realms and their on-disk layout, exposes the control plane, and coordinates inter-yuno communication. ycommand, ystats, ylist and ybatch talk to this yuno by default.

Control plane ports¶

Connecting out to a control center¶

When the node has an owner (node_owner ≠ "none"), the agent starts an outbound C_IEVENT_CLI client service named controlcenter and dials the control center. The remote URL is assembled from config variables:

tcps://(^^__sys_machine__^^).(^^__node_owner__^^).(^^__output_url__^^)

i.e. tcps://<machine>.<node_owner>.<output_url>, where __output_url__ defaults to yunetacontrol.com:1994. With an empty/none owner the agent does not dial out. See controlcenter for the operator side.

Redundancy¶

Every node also runs yuneta_agent22, a minimal second agent kept alive as an escape hatch so a node is never left unmanageable.

Deep dive¶

The agent is documented at length under Operating Yuneta:

• Entry point (main + watcher)

• Yuno lifecycle

• Debugging a yuno

• Inter-process communication

• Realms (multi-tenancy)

• Scaffolding new yunos

• Auth, permissions, TLS

• gobj framework crash course

• timeranger2 + treedb crash course