Rook项目版本发布自动化脚本开发需求解析

在Rook项目的版本发布流程中，目前存在一个亟待解决的痛点问题：版本号的手动更新过程容易出错且效率低下。本文将从技术角度深入分析这一问题的背景、现有解决方案的不足，以及理想的自动化实现方案。

当前版本更新流程的痛点

Rook项目目前采用人工搜索替换的方式来更新版本号标记，这种方法存在两个主要缺陷：

1. 容易遗漏关键位置的版本号更新（如Helm Chart中的版本标记）
2. 可能错误修改不应更改的文件内容

典型问题案例包括：

• 在1.17分支中，错误地修改了不应变更的文件
• 1.18版本发布时，Helm Chart因版本更新遗漏而发布了错误的版本

自动化解决方案设计要点

理想的自动化脚本应具备以下核心功能：

1. 版本号智能替换：

   • 首次在发布分支运行时，将"master"标记替换为beta版本号（如v1.18.0-beta.0）
   • 后续运行时，将旧版本号替换为新版本号（如v1.18.1→v1.18.2）

2. 精确文件定位：

   • 仅修改预先定义的关键文件列表
   • 避免全局搜索替换带来的副作用

3. 参数化设计：

   • 通过命令行参数接收目标版本号
   • 示例调用方式：

     tests/scripts/set-version.sh v1.18.2
     

技术实现建议

推荐采用以下实现方案：

1. 文件白名单机制：

   • 维护一个包含所有需要版本更新的文件路径列表
   • 包括但不限于：文档文件、Helm Chart配置、CI/CD配置文件等

2. 版本号替换逻辑：

   • 使用正则表达式确保精确匹配
   • 区分首次发布（master→版本号）和后续更新（旧版本→新版本）

3. 安全机制：

   • 执行前显示变更预览
   • 支持dry-run模式验证修改效果

预期收益

实现该自动化脚本后将带来以下改进：

• 消除人为操作失误导致的版本不一致问题
• 提高版本发布流程的效率
• 为后续CI/CD集成奠定基础
• 提升发布过程的可重复性和可靠性

该解决方案虽然看似简单，但对保证Rook项目的发布质量具有重要意义，是构建健壮发布流程的关键一步。