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

背景与挑战

随着Sonatype官方宣布OSSRH（OSS Repository Hosting）服务将于2025年6月25日终止，所有基于Maven中央仓库发布Java组件的项目都需要迁移至新的Central Publishing Portal平台。作为Java生态中重要的微服务框架，Helidon项目需要完成这一关键基础设施迁移，以确保后续版本的正常发布。

迁移技术要点

认证机制变更

原OSSRH使用传统的用户名/密码结合GPG签名进行身份验证，而Central Portal采用更现代化的Token机制。项目维护者需要：

1. 通过Sonatype账户生成专属的发布令牌
2. 在CI/CD系统中安全存储这些凭证
3. 更新构建脚本以适配新的认证方式

发布流程重构

新的发布API采用Bundle上传模式，与传统的Maven直接部署有显著差异：

• 需要将整个发布包（包括POM、主构件、源码、Javadoc等）打包为单一ZIP文件
• 支持先上传到临时区域进行验证（类似原OSSRH的staging）
• 提供API接口用于最终发布或丢弃暂存内容

快照支持

Central Portal保留了SNAPSHOT版本支持机制，但实现方式有所调整：

• 快照仓库URL变更
• 上传元数据格式优化
• 保留期限策略更新

实施过程

Helidon团队采用分阶段迁移策略：

1. 前期准备（2025年4月）

   • 创建Portal专属Token
   • 在非生产环境测试发布流程
   • 更新CI/CD流水线脚本

2. 关键迁移（2025年5月）

   • 提交namespace迁移申请
   • 验证全量发布流程
   • 建立回滚预案

3. 版本验证（2025年6月）

   • 执行4.2.x版本的完整发布演练
   • 确认所有附属构件（如javadoc、sources）正常发布
   • 更新项目文档中的发布指南

技术决策

项目团队选择优先在main分支和4.2.x长期支持分支实施迁移，主要考虑：

• 确保新功能开发不受影响
• 保障当前稳定分支的维护能力
• 后续再向其他历史分支回迁

经验总结

1. 命名空间迁移是单向不可逆操作，必须确保所有工具链就绪后再执行
2. Bundle上传模式虽然需要调整构建脚本，但提供了更好的原子性保证
3. 新的API接口更适合自动化集成，减少了人工干预环节
4. 建议所有依赖Maven中央库的Java项目尽早规划迁移

这次迁移不仅是发布平台的更换，更是对项目发布流程的一次现代化升级，为Helidon后续的持续交付奠定了更可靠的基础设施。