name: release description: “运行完整的发布流程。用于创建ctx的新版本。”
执行Context CLI的发布流程。
运行前准备
所有三个前提条件必须满足:
- VERSION 文件已更新为新版本号
dist/RELEASE_NOTES.md文件存在(使用/release-notes生成)- 工作区是干净的(所有更改已提交)
如果任何前提条件不满足,请停止并告知用户需要修复的内容。
何时使用
- 当需要为ctx创建带标签的发布版本时
- 当用户说“发布”、“上线”或“创建发布”时
何时不使用
- 当仅需生成发布说明时(使用
/release-notes) - 当进行预演或预览时
流程
- 验证前提条件:
cat VERSION
test -f dist/RELEASE_NOTES.md && echo "发布说明:正常" || echo "缺失"
git status --porcelain
- 运行发布脚本:
make release
此脚本将:
- 更新
docs/index.md中的版本引用 - 重新构建文档站点
- 提交文档更新
- 运行测试和冒烟测试
- 为所有平台构建二进制文件
- 创建并推送一个带签名的Git标签
- 更新
latest标签
- 完成后,提醒用户在脚本输出中显示的URL处创建GitHub发布,并从
dist/目录上传二进制文件。
质量检查清单
- [ ] 运行前已更新VERSION
- [ ]
dist/RELEASE_NOTES.md文件存在 - [ ] 工作区是干净的
- [ ] 测试和冒烟测试通过
- [ ] 标签已推送到origin
- [ ] 已提醒用户创建GitHub发布