The Sourdough Framework 项目中的CI/CD流程优化实践

在开源项目The Sourdough Framework的开发过程中，团队针对持续集成/持续部署(CI/CD)流程进行了优化调整，主要解决了构建效率问题和触发条件不明确的情况。

原有CI流程的问题

最初的项目CI流程存在几个明显缺陷：

1. 仅在推送到分支时构建网站部分，而忽略了PDF和电子书的构建
2. 构建任务触发条件不够明确，导致部分场景下构建不完整
3. 整体构建时间较长，特别是在合并到主分支时需要30分钟

优化后的CI策略

经过调整后，新的CI流程根据不同的Git操作采取了差异化的构建策略：

1. 推送到分支：同时构建书籍PDF和网站部分，充分利用并行构建能力
2. 创建Pull Request：触发与推送到分支相同的构建流程
3. 合并到主分支：构建完整的Docker镜像，包含所有版本(2种PDF格式、电子书、黑白版和网站)
4. 直接推送到主分支：与合并操作相同的完整构建流程

技术实现要点

优化后的CI流程特别注意了以下几点：

1. 构建任务并行化：将网站构建和PDF生成设置为并行任务，将原本需要顺序执行的5分钟任务缩短为并行完成
2. 条件触发机制：精确控制不同Git操作触发的构建内容，避免不必要的资源消耗
3. Docker镜像管理：仅在主分支变更时构建和推送带有"latest"标签的Docker镜像
4. PR构建优化：虽然PR初始创建时会触发两次构建，但后续推送仅触发单次构建

遇到的挑战与解决方案

在优化过程中，团队遇到了版本发布不更新的问题。经排查发现是发布工作流中的配置错误导致的。通过修复发布工作流配置，确保了每次构建后版本信息的正确更新。

优化效果

经过上述调整：

• 常规开发中的构建时间从30分钟大幅降低
• 资源利用率提高，不必要的构建任务减少
• 版本发布更加可靠和及时
• 开发体验显著改善，特别是频繁提交时的等待时间缩短

这种针对不同开发场景定制CI策略的方法，为类似的技术文档项目提供了有价值的参考。通过合理划分构建任务和精确控制触发条件，可以在保证质量的前提下显著提升开发效率。