github.com/cetanu/sovereign ↗
JSON control-plane for Lyft's Envoy proxy
Open this visualization on its own page →
Contributors
5
Lines of Code
1,510
From
2019-01-17
To
2020-11-11
About cetanu/sovereign
Sovereign is a JSON-based control plane for Envoy proxy, created at Atlassian to enable dynamic configuration management. Instead of requiring static deployment of Envoy configurations, Sovereign uses templates for Envoy resource types like clusters, routes, listeners, and secrets, then enriches these templates with data fetched from various sources. This allows Envoy configurations to change over time without needing to redeploy the control plane itself.
The project provides built-in data polling mechanisms over HTTP and from disk, but also exposes extension points so operators can write custom Python plugins to integrate their own data sources. Sovereign supplies downstream Envoy proxies with updated configuration based on these dynamic data sources, making it suitable for large-scale deployments where infrastructure changes frequently. The project requires Python 3.8 or later and uses FastAPI as part of its implementation.