Helidon项目从OSSRH迁移至Central Publishing Portal的技术实践

随着Sonatype官方宣布OSSRH服务将于2025年6月25日终止维护，Helidon团队近期完成了从传统OSSRH到新一代Central Publishing Portal的发布系统迁移。本文将从技术视角解析这一迁移过程的核心要点。

迁移背景与必要性

Central Publishing Portal是Sonatype推出的现代化组件发布平台，相比传统OSSRH具有更简化的发布流程和增强的安全特性。对于像Helidon这样的开源项目而言，及时迁移不仅能确保持续的版本发布能力，还能利用新平台的自动化优势。

技术迁移方案

认证体系重构

项目首先需要创建专用的Portal User Token替代原有的OSSRH认证凭据。这种基于令牌的机制提供了更细粒度的访问控制，且支持多因素认证。

发布流程改造

发布脚本需要适配Central Portal的REST API接口，主要涉及：

1. 组件Bundle的上传机制调整
2. 支持手动测试部署包的功能
3. SNAPSHOT版本的特殊处理逻辑

命名空间迁移

关键的io.helidon命名空间需要完成平台间转移，这一操作具有不可逆性。迁移后所有组件发布将强制通过新平台进行。

实施验证策略

团队采用分阶段验证方案：

1. 在非生产分支进行完整发布流程测试
2. 特别验证"staged release"的预发布机制
3. 确认版本回滚等应急方案可行性
4. 最终在生产分支执行正式发布

版本兼容性处理

考虑到多版本分支的并行维护需求，迁移工作首先在main和helidon-4.2.x分支完成，后续将通过独立issue跟踪其他分支的适配工作。这种渐进式迁移策略有效降低了系统风险。

开发者影响说明

对于普通开发者而言，此次后端发布系统的变更不会影响日常的依赖获取。但核心维护团队需要注意：

• 发布前必须更新本地构建环境配置
• 熟悉新的发布审核流程
• 掌握Portal平台提供的发布状态监控功能

通过这次系统迁移，Helidon项目不仅确保了构建发布管道的可持续性，也为未来更高效的组件管理奠定了基础。