最完整的Langflow版本发布指南：从开发到部署的全流程规范
项目地址: https://gitcode.com/GitHub_Trending/la/langflow 你还在为版本发布流程混乱而困扰吗？团队协作时是否经常出现分支管理混乱、版本号冲突的问题？本文将详细介绍Langflow的发布流程规范，帮助你轻松掌握从开发到部署的全流程，确保每次版本发布都稳定高效。读完本文，你将了解Langflow的分支模型、版本号管理、发布步骤以及常见问题解答，让你的版本发布工作不再手忙脚乱。
发布流程概述
Langflow采用“就绪即发布”的节奏，每个发布周期通常持续4-6周，具体时间取决于QA和稳定性需求。发布流程主要包括OSS QA、Desktop QA和正式发布三个阶段。OSS QA阶段创建发布候选分支，进行手动测试和bug修复；Desktop QA阶段基于最终的OSS RC版本进行测试；正式发布阶段则从各自的RC分支发布最终版本，并在发布后24小时内监控支持渠道以应对关键bug报告。
分支模型
Langflow的分支模型简洁明了，主要包括main分支和release-X.Y.Z分支。main分支是集成分支，所有功能PR默认都指向该分支，采用“Squash & Merge”策略以保持线性历史。release-X.Y.Z分支是临时的发布候选分支，仅在发布周期内活跃，接受标记为type:release的QA和阻塞性bug PR，同样采用“Squash & Merge”策略，并在最终合并前基于main分支进行变基。
| Branch | Purpose | Merge Policy |
|---|---|---|
main | Integration branch. All feature PRs target this by default. | Squash & Merge (linear history) |
release-X.Y.Z(e.g. release-1.4.3) | Temporary RC branch. Active only for the release cycle. Accepts QA and blocking-bug PRs labeled type:release. | Squash & Merge within the branch. Rebased onto main before final merge. |
版本号管理
Langflow遵循语义化版本规范，版本号格式为MAJOR.MINOR.PATCH。其中，MAJOR版本用于不兼容的API变更，MINOR版本用于向后兼容的功能性新增，PATCH版本用于向后兼容的问题修复。发布候选版本的标签使用-rc.N格式，例如v1.8.0-rc.1。
版本号相关的工具函数定义在src/lfx/src/lfx/utils/version.py文件中。get_version_info()函数返回版本信息，当前返回{"version": "0.1.0", "package": "lfx"}；is_pre_release()函数用于检查版本是否为预发布版本，通过判断版本字符串中是否包含alpha、beta、rc等预发布指示器来实现。
发布步骤
1. 创建发布候选分支
首先确保本地main分支是最新的，然后创建并推送发布候选分支：
git checkout main && git pull # Ensure local main is up to date
git checkout -b release-X.Y.Z # Create new release candidate branch
git push -u origin release-X.Y.Z # Push RC branch to remote
2. 在RC分支上应用Bug修复
如果需要在RC分支上修复bug，首先创建功能分支，然后打开指向release-X.Y.Z的GitHub PR，经过审核和批准后合并到RC分支。
3. 正式发布
完成所有测试和修复后，从RC分支创建并推送最终发布标签：
git checkout release-X.Y.Z && git pull # Ensure RC branch is up to date
git tag vX.Y.Z # Create final release tag
git push origin vX.Y.Z # Push tag to remote
4. 将RC分支合并回main分支
最后，将RC分支的更改合并回main分支：
git checkout main
git merge --ff-only release-X.Y.Z # Fast-forward main to include RC changes
角色与职责
在Langflow的版本发布流程中，不同角色承担着不同的职责。发布负责人（每个周期轮换）负责时间线、分支创建、标记和合并回主分支；PR作者确保测试通过，并在需要时使用type:release标记PR；CI则在测试失败或标签缺失时阻止合并。
| Role | Responsibility |
|---|---|
| Release Captain (rotates per cycle) | Owns timeline, branch cut, tagging, merge-back. |
| PR Author | Ensures tests pass; flags PR with type:release if needed in RC. |
| CI | Blocks merges on failing tests or missing labels. |
常见问题解答
我们是否曾经将main分支合并到RC分支？
不，为了保持线性历史，我们总是将RC分支变基到main分支上。
我们可以自动删除分支吗？
目前还不能，合并回主分支和清理工作都是手动进行的。
时间线的灵活性如何？
时间线非常灵活，QA和稳定阶段可以根据质量需求进行延长。
通过本文的介绍，相信你已经对Langflow的版本发布流程有了全面的了解。遵循这些规范，将有助于你和团队更高效地进行版本发布工作，确保每次发布都稳定可靠。如果你在实际操作中遇到任何问题，可以参考官方文档RELEASE.md或咨询团队中的发布负责人。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
