marioezquerro/gubernator repository overview

⁠Gubernator⁠

Gubernator is a powerful "Goldilocks" orchestrator that combines the simplicity of Docker Swarm (native Compose support, easy cluster joining) with the flexibility of Nomad (task-based logic, labels for hardware/AI targeting).

Themed around the Roman Empire, Gubernator aims to manage your containers robustly across a fleet of nodes ("Centurions") managed by a central API ("The Senate").

---

⁠Architecture Overview

Gubernator operates using a single, portable binary (gbnt) that can run as either a Manager or a Worker.

• API & CLI: Built with Gin and Cobra.
• State: Powered by SQLite and GORM.
• Container Engine: Direct communication with the Docker Engine.
• Web Dashboard: Flutter Web with Material Design 3 (embedded into the Go binary).
• Ingress & DNS: Built-in hooks for CoreDNS (internal resolution) and Caddy (external ingress).