Migration of Onyxia API to Go

[trygu]

We are excited to announce the planned migration of the Onyxia API to Go! 🚀

Why this Migration?

The Onyxia API is a core component of the Onyxia service, responsible for handling Kubernetes environments, including namespace management, access control, and service configuration. The existing Java-based API has presented challenges in security, maintainability, and performance. Migrating to Go will bring:

✅ Enhanced Security - Addressing past vulnerabilities and ensuring compliance with best practices.
✅ Better Maintainability - A cleaner, more modular codebase that is easier to extend.
✅ Multi-Region Support - A future goal is enabling Onyxia API deployments in multiple regions.
✅ Improved Performance - Go's lightweight concurrency model is better suited for high-parallelism workloads.

The Migration Plan

The transition will happen in three phases:

Phase 1: Foundation & Tracer Bullet API (Q1-Q2 2025)

• Develop a "tracer bullet" API for the onboarding and bootstrap services.
• Define OpenAPI v3 specifications for API endpoints.
• Implement user mapping and session handling.
• The onboarding service will handle Kubernetes namespace creation.
• The bootstrap service will manage Onyxia Web configuration and multi-region metadata.

Phase 2: Core API Migration (Q2-Q3 2025)

• Expand the Go implementation to core components (catalog services, etc.).
• Migrate authentication from Spring Security to OAuth/JWT.
• Ensure compliance with RFC 9457 to improve API error handling.
• Enhance observability and logging for better system insight.

Phase 3: Full Transition & Java API Deprecation (Q3 2025)

• Complete the full migration to Go.
• Conduct production testing and performance tuning.
• Deprecate the Java API and transition fully to Go.
• Prepare for future feature expansions.

Follow the Migration!

This project is open-source and welcomes contributions and feedback. Development is happening in our new GitHub repository:
➡️ Onyxia Onboarding Repository

We will share updates as development progresses. Feel free to engage, ask questions, or contribute! 🚀