14、持续交付(CD):二进制产物管理、版本号语义化、发布流程自动化
聊到持续交付,很多团队其实只做到了“持续集成”。代码能编过、测试能跑通,就觉得万事大吉了。但真正到了上线那一刻,手忙脚乱地找包、确认版本、手动上传……我见过不少项目,就卡在这一步上。
说白了,持续交付的核心就三件事:管好产物、定好版本、自动化发布。今天咱们就掰开揉碎了聊聊。
一、二进制产物管理:别让“包”丢了
你想想看,一个大型C++项目,编译一次可能半小时甚至更久。如果产物管理混乱,开发人员各自从本地拷来拷去,那简直是灾难。
我个人习惯,产物管理必须遵循几个原则:
- 唯一性:每个构建产物必须有唯一的标识,不能覆盖。
- 可追溯:拿到一个二进制文件,能反查到它来自哪个代码版本、哪个构建任务。
- 不可变性:一旦上传,就不能再修改。要改就重新构建。
产物仓库的选择
我建议使用专门的二进制仓库管理工具,比如 JFrog Artifactory 或者 Nexus。它们支持多种包格式,也支持元数据标记。
举个例子,我们团队产出的产物命名规则是这样的:
项目名_分支名_构建编号_平台_架构.后缀
例如:GameServer_master_1024_linux_x86_64.tar.gz
嗯,这里要注意:不要用时间戳作为唯一标识。同一秒内可能触发多次构建,时间戳会重复。用构建编号(Build Number)更靠谱。
二、版本号语义化:一眼看懂版本含义
版本号这东西,看似简单,但我在项目中踩过不少坑。最典型的就是:开发人员随手写了个“v2.1”,结果没人知道这个版本到底改了啥,能不能直接上线。
我强烈推荐使用语义化版本号(Semantic Versioning)。格式很简单:
主版本号.次版本号.修订号
规则也很清晰:
| 版本位 | 变更含义 | 举例 |
|---|---|---|
| 主版本号 | 不兼容的API修改 | 3.0.0 → 4.0.0 |
| 次版本号 | 向下兼容的功能新增 | 3.1.0 → 3.2.0 |
| 修订号 | 向下兼容的问题修正 | 3.1.0 → 3.1.1 |
我的一个小技巧
在预发布阶段,可以加上“-alpha”、“-beta”、“-rc.1”这样的预发布标识。比如 2.0.0-rc.1,表示这是2.0.0的第一个候选发布版本。
为什么会这样设计?因为语义化版本号能直接告诉下游使用者:这个版本升级的风险有多大。主版本号变了,说明要改代码;修订号变了,直接替换就行。
我曾经遇到过一个项目,版本号从 1.9.9 直接跳到 1.10.0。你猜怎么着?有人以为 1.10.0 比 1.9.9 小,因为“10”比“9”大,但字符串比较时“1.10.0”比“1.9.9”小。所以记住:版本号比较要用数值比较,别用字符串。
三、发布流程自动化:把“人”从流程中解放出来
手动发布,说白了就是给自己挖坑。我记得有一次,凌晨两点上线,运维同学手抖点错了版本,回滚花了两个小时……从那以后,我坚持所有发布流程必须自动化。
一个标准的自动化发布流程,大致包含这几个阶段:
- 触发构建:代码合并到主分支后,自动触发构建。
- 产物生成与上传:构建完成后,自动打包并上传到产物仓库。
- 版本号自动生成:根据语义化规则,自动生成下一个版本号。
- 发布审批:通知相关人员进行审批(可选)。
- 自动部署:审批通过后,自动将产物部署到目标环境。
- 健康检查:部署完成后,自动运行冒烟测试。
注意: 自动化不等于“无人值守”。关键环境(比如生产环境)的发布,建议保留人工审批环节。自动化负责“执行”,人负责“决策”。
这里我分享一个用 Jenkins Pipeline 实现的简单发布脚本片段:
pipeline {
agent any
stages {
stage('构建') {
steps {
sh 'make clean && make -j$(nproc)'
}
}
stage('上传产物') {
steps {
// 使用构建编号作为版本标识
sh 'curl -u user:pass -T output.tar.gz "http://artifactory:8081/repo/GameServer_master_${BUILD_NUMBER}_linux_x86_64.tar.gz"'
}
}
stage('部署测试环境') {
steps {
sh 'ansible-playbook deploy.yml -e version=${BUILD_NUMBER}'
}
}
}
}
你可能会问:版本号怎么自动生成?我一般用 Git 标签来管理。每次发布时,自动打上语义化版本号的标签,然后通过 Git 历史来推断下一个版本号。
举个例子:
# 获取当前最新标签
git describe --tags --abbrev=0
# 输出: v2.3.1
# 然后根据提交信息判断版本类型
# 如果有 "BREAKING CHANGE" 关键字 → 主版本+1
# 如果有 "feat" 关键字 → 次版本+1
# 否则 → 修订号+1
嗯,这里要注意:版本号的生成逻辑一定要和代码提交规范绑定。如果团队没有统一的 Commit Message 规范,自动生成版本号就是空中楼阁。
四、避坑指南:我踩过的那些坑
做持续交付这么多年,有些坑我至今记忆犹新:
- 产物清理策略:产物仓库不是垃圾桶。我建议设置保留策略,比如只保留最近30天的产物,或者只保留每个版本的最后一个构建。
- 版本号不要手动修改:一旦开始自动化,就不要在构建脚本里硬编码版本号。所有版本号都应该从 CI/CD 系统或 Git 标签中自动获取。
- 回滚能力:自动化发布一定要考虑回滚。每次发布前,自动备份当前版本的产物和配置。回滚时,一键恢复到上一个版本。
- 环境一致性:我曾经遇到过测试环境能跑,生产环境就崩的情况。后来发现是依赖库版本不一致。所以,产物中要包含所有依赖,或者使用容器化技术保证环境一致。
总结一下
持续交付不是一蹴而就的。我建议先从“产物管理”和“版本号规范化”做起,这两步做好了,自动化发布就是水到渠成的事。别想着一步到位,小步快跑才是正道。
最后说一句:自动化发布不是为了取代人,而是让人去做更有价值的事。把重复的、容易出错的工作交给机器,把决策和创新的空间留给自己。