Apache Storm项目版本发布流程详解

Apache Storm项目版本发布流程详解

storm Apache Storm 项目地址: https://gitcode.com/gh_mirrors/storm22/storm

前言

Apache Storm作为分布式实时计算系统的标杆项目，其版本发布流程遵循Apache软件基金会的严格规范。本文将深入解析Storm项目的版本发布策略、准备工作和完整发布流程，帮助开发者理解开源项目如何保证版本质量和发布规范性。

版本策略

Storm项目采用语义化版本控制(SemVer)规范，版本号格式为MAJOR.MINOR.PATCH：

1. 主版本号(MAJOR)：当进行不兼容的API变更时递增
2. 次版本号(MINOR)：当新增向后兼容的功能时递增
3. 修订号(PATCH)：当进行向后兼容的问题修正时递增

这种版本策略能够清晰地向用户传达版本变更的性质和影响范围。

发布前准备

基础设施配置

1. Apache仓库权限：确保能登录Apache仓库管理系统
2. SVN客户端：配置好对dev和release目录的访问权限
3. Maven配置：在settings.xml中正确设置Apache LDAP凭证
4. GPG密钥：准备已签名的GPG密钥并注册到Storm项目的KEYS文件

开发环境要求

• NodeJS和Python3：部分测试用例依赖这些运行时环境
• Docker环境：确保Docker服务正常运行，/var/run/docker.sock权限正确

分支策略

创建新次要版本时：

1. 从master分支创建新分支（如2.6.x-branch）
2. 在master分支上将版本号升级为下一个次要版本（如2.3.0-SNAPSHOT）

发布投票流程

1. 创建发布候选版本

mvn release:prepare -P dist,rat,externals,examples
mvn release:perform -P dist,rat,externals,examples

此过程会：

• 创建两个带特定标记的提交
• 生成并推送Git标签（如v2.6.0）
• 在Apache仓库创建"staging repository"

2. 构建和打包

git checkout tags/v2.6.0 -b v2.6.0
mvn clean install -DskipTests
mvn package

3. 生成校验文件

sha512sum apache-storm-2.6.0-src.zip > apache-storm-2.6.0-src.zip.sha512

4. 准备发布说明

python3 dev-tools/release_notes.py 2.6.0 > RELEASE_NOTES.html
gpg --armor --output RELEASE_NOTES.html.asc --detach-sig RELEASE_NOTES.html

5. 提交到SVN仓库

将所有生成的文件提交到dev目录下的特定RC目录中。

6. 发起投票

按照Apache投票流程，向开发邮件列表发送投票请求，模板包含：

• 仓库位置
• 发布文件位置
• GPG密钥信息
• 变更列表
• 投票说明

投票通过后的发布流程

1. 移动文件：将文件从dev目录移动到release目录
2. 发布仓库：在Apache仓库管理界面发布staging仓库
3. 等待同步：至少等待24小时让镜像同步完成
4. 更新网站：更新项目网站和下载页面
5. 更新元数据：更新doap_Storm.rdf文件
6. 发送公告：向相关邮件列表发送发布公告
7. 清理旧版本：归档过期的发布版本

投票失败处理

1. 通知开发邮件列表
2. 删除staging仓库
3. 清理SVN中的候选文件
4. 删除Git标签
5. 发送取消通知

如何参与版本评审

社区鼓励所有人参与发布候选版本的评审，常见检查项包括：

1. 文件验证：校验签名和校验和文件
2. 构建测试：从源码构建并运行单元测试
3. 集群测试：使用不同格式的发布包搭建独立集群
4. 功能测试：
   • 运行示例拓扑（如WordCountTopology）
   • 测试UI功能（日志搜索、堆转储等）
   • 测试CLI命令（kill、list、rebalance等）
5. 安全测试：搭建安全集群进行基础功能验证

参与评审后，在投票邮件中回复你的验证结果和发现的问题。

结语

Apache Storm严格的发布流程确保了每个版本的可靠性和质量。理解这一流程不仅有助于项目维护者规范发布操作，也能帮助贡献者更有效地参与项目质量保障。通过社区成员的共同验证，Storm项目能够持续提供稳定可靠的实时计算解决方案。

storm Apache Storm 项目地址: https://gitcode.com/gh_mirrors/storm22/storm