Section 15: Agent Architecture
Overview
Agents are high-trust components deployed on customer hardware to manage game servers. They handle process lifecycle, file management, and real-time communication.
Agent Types
| Project | Platform | Purpose |
|---|---|---|
| Dhadgar.Agent.Core | Cross-platform | Shared logic, abstractions |
| Dhadgar.Agent.Linux | Linux | Linux-specific implementation |
| Dhadgar.Agent.Windows | Windows | Windows-specific implementation |
Communication Model
Outbound-Only Design:
- - Agents initiate all connections to control plane
- - No inbound firewall rules required
- - WebSocket for real-time commands
- - HTTP for file transfers and API calls
Security Model
High Trust: Agents run with elevated privileges to manage game server processes.
mTLS certificates authenticate agents to control plane. Short-lived certificates with automatic rotation.
Capabilities
Process Management
Start, stop, restart game server processes
File Operations
Download, upload, backup game files
Console Streaming
Real-time stdout/stdin relay via SignalR
Health Reporting
CPU, memory, disk usage metrics