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”小。所以记住:版本号比较要用数值比较,别用字符串。

三、发布流程自动化:把“人”从流程中解放出来

手动发布,说白了就是给自己挖坑。我记得有一次,凌晨两点上线,运维同学手抖点错了版本,回滚花了两个小时……从那以后,我坚持所有发布流程必须自动化。

一个标准的自动化发布流程,大致包含这几个阶段:

  1. 触发构建:代码合并到主分支后,自动触发构建。
  2. 产物生成与上传:构建完成后,自动打包并上传到产物仓库。
  3. 版本号自动生成:根据语义化规则,自动生成下一个版本号。
  4. 发布审批:通知相关人员进行审批(可选)。
  5. 自动部署:审批通过后,自动将产物部署到目标环境。
  6. 健康检查:部署完成后,自动运行冒烟测试。

注意: 自动化不等于“无人值守”。关键环境(比如生产环境)的发布,建议保留人工审批环节。自动化负责“执行”,人负责“决策”。

这里我分享一个用 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 标签中自动获取。
  • 回滚能力:自动化发布一定要考虑回滚。每次发布前,自动备份当前版本的产物和配置。回滚时,一键恢复到上一个版本。
  • 环境一致性:我曾经遇到过测试环境能跑,生产环境就崩的情况。后来发现是依赖库版本不一致。所以,产物中要包含所有依赖,或者使用容器化技术保证环境一致。

总结一下

持续交付不是一蹴而就的。我建议先从“产物管理”和“版本号规范化”做起,这两步做好了,自动化发布就是水到渠成的事。别想着一步到位,小步快跑才是正道。

最后说一句:自动化发布不是为了取代人,而是让人去做更有价值的事。把重复的、容易出错的工作交给机器,把决策和创新的空间留给自己。