OpenSERP v0.6.0
This release focuses on server reliability, proxy control, and deployment readiness.
Highlights
- Added
/healthendpoint for lightweight service checks. - Added retries, circuit breaker protection, optional dedicated-endpoint fallback, and CORS controls for server mode.
- Added bounded TTL response cache for dedicated and mega endpoints.
- Added proxy support with tagged proxy pools, health-based rotation, fail-closed behavior, and runtime proxy selection.
- Added per-request proxy override via
X-Use-Proxyheader. - Added proxy and resilience observability through
/stats,/stats/cache,/stats/proxy, and/stats/cb. - Added custom browser binary path support.
- Expanded query controls with Google
filtersupport and broaderstartpagination support.
Proxy and Runtime Improvements
- Reworked proxy configuration around
proxies.global,proxies.entries, and per-engine proxy tags. - Added lazy browser reuse per effective proxy to avoid duplicate browser launches across engines.
- Added runtime proxy override support for API requests without restarting the server.
- Improved fail-closed behavior when a required proxy tag has no healthy candidates.
- Added masked proxy reporting so response headers and stats do not expose credentials.
Caching and Resilience
- Added cache support for dedicated endpoints and mega endpoints with bounded size and TTL.
- Avoid fallback-response caching on dedicated endpoints so the primary engine can recover naturally.
- Added retry and circuit-breaker behavior around engine execution.
- Added resilience stats endpoints for easier troubleshooting in server deployments.
Packaging and Config
- Updated the default shipped
config.yamlto use safe direct-traffic defaults instead of local proxy test endpoints. - Fixed Docker image config discovery by setting the app working directory to the config location.
- Fixed
docker-compose.yamlenvironment keys to the currentserver.*config names. - Fixed explicit
--configloading so a provided config file path is actually used.
Acknowledgements
- Parts of the ideas and implementation direction for this release were originally explored in PR #21 by Sai-Prashanth123: #21
- That PR contributed useful groundwork around production-readiness areas such as health checks, caching, CORS, structured errors, request logging, and resilience-related server improvements.
- The final
0.6.0implementation was reviewed, reworked, debugged, and adapted further in the main codebase to match OpenSERP's current project vision and configuration model.
Full Changelog: v0.5.4...v0.6.0