How ezequielribeiro/distributed-server-manager works
Capivara DSM is a distributed, multi-game server manager with a Controller, Linux/Windows Agents, and a hybrid mode. Its main customer workflow is contract-authorized instance creation: the Controller selects a suitable Agent, ensures shared game data is available, then asks the Agent to materialize and operate the instance. Other major capabilities include catalog and content management, backups, maintenance, observability and alerts, and storage-pool migration. The README documents the broad architecture; sampled source supports several Agent, persistence, and alerting details, but not every Controller-to-Agent dispatch.
Main entry points: agent_instance_provisioning_api.py Provisioning · agent.py Linux Agent · instance_runtime.py Instance Runtime · instance_creation_http.py Instance Creation
Components 24
Controller and Dashboard
- Customer APIs
dashboard/customer_instance_creation.py - Instance Creation
dashboard/instance_creation_http.py - Placement
core/placement/placement_policy.py - Agent Fleet
core/agent_lifecycle.py
Catalog and Provisioning
- Catalog Runtime
core/catalog_index.py - Game Data
core/content_platform.py - Provisioning
dashboard/agent_instance_provisioning_api.py
Agent Runtime
- Linux Agent
agents/linux/runtime/agent.py - Windows Agent
agents/windows/runtime/agent.py - Instance Runtime
agents/linux/runtime/instance_runtime.py - Privileged Materializer
agents/linux/runtime/privileged_materialization.py - Operation Journal
agents/linux/runtime/runtime_operations.py
Operations and Content
- Content Management
dashboard/content_api.py - Backup
agents/linux/runtime/backup_client.py - Maintenance
dashboard/workers/maintenance_worker.py - Storage Migration
agents/linux/runtime/storage_pool_migration_executor.py - Storage Pools
agents/linux/runtime/storage_pools.py
Persistence and Events
- Database
database/backend.py - Configuration Repository
database/configuration_repository.py - Universal Events
database/universal_event_repository.py - Alert Evaluator
monitor/alert_engine.py - Alert Repository
database/alert_repository.py
Other components
- Customer
- Administrator
Connections 24
- Customer → Customer APIs: requests service
README.md - Customer APIs → Instance Creation: starts creation
- Administrator → Catalog Runtime: manages catalog
README.md - Instance Creation → Placement: requests placement
README.md - Placement → Agent Fleet: selects Agent
README.md - Instance Creation → Provisioning: coordinates provisioning
README.md - Provisioning → Game Data: ensures game data
README.md - Provisioning → Linux Agent: dispatches provisioning
README.md - Provisioning → Windows Agent: dispatches provisioning
README.md - Catalog Runtime → Game Data: defines runtime needs
README.md - Linux Agent → Instance Runtime: observes instances
agents/linux/runtime/instance_runtime.py - Linux Agent → Privileged Materializer: invokes materializer
agents/linux/runtime/privileged_materialization.py - Privileged Materializer → Instance Runtime: registers instance
agents/linux/runtime/privileged_materialization.py - Instance Runtime → Operation Journal: journals operations
agents/linux/runtime/instance_runtime.py - Administrator → Content Management: manages content
README.md - Administrator → Backup: operates backups
README.md - Maintenance → Linux Agent: coordinates maintenance
- Administrator → Storage Pools: configures pools
README.md - Storage Migration → Storage Pools: resolves pools
agents/linux/runtime/storage_pool_migration_executor.py - Storage Migration → Instance Runtime: registers after rollback
agents/linux/runtime/storage_pool_migration_executor.py - Configuration Repository → Database: persists settings
database/configuration_repository.py - Universal Events → Database: stores events
- Alert Evaluator → Alert Repository: evaluates and reconciles
monitor/alert_engine.py - Alert Repository → Database: persists alerts
database/alert_repository.py