构建
构建的目标:从源码到可复现、可追溯、可回滚的制品。
1. 三件事
| 目标 | 含义 | 检查方式 |
|---|---|---|
| 可复现 | 同一提交在任何机器上产出相同制品 | 固定依赖与运行时版本 |
| 可追溯 | 每个制品能对应到提交与变更 | 版本号关联 commit |
| 可回滚 | 出问题时能回到上一个可用版本 | 制品保留策略 |
2. 依赖管理
- Java 侧用 Maven 统一管理依赖,父工程收敛版本;
- Node 侧用 Yarn 或 Npm,提交锁文件,避免版本漂移;
- 依赖统一走私有制品库或官方源,禁止来源不明的包;
- 同一能力不引入多套同类组件,减少排障面。
3. 模块与构建
- 多模块工程统一版本号,按交付单元打包;
- 构建脚本纳入版本管理,本地与流水线使用同一脚本;
- 使用构建缓存缩短时间,但缓存不能成为可复现性的依赖;
- 基础镜像与运行时版本固定,构建环境与应用环境一致。
4. 流水线
典型阶段:构建 → 测试 → 扫描 → 制品 → 发布。
| 阶段 | 要求 |
|---|---|
| 构建 | 失败即阻断,不允许"本地能过" |
| 测试 | 单元与接口测试作为门禁 |
| 扫描 | 依赖漏洞与代码规范检查 |
| 制品 | 上传制品库,记录版本与提交 |
| 发布 | 与运维流程衔接,保留回滚点 |
分支策略按团队规模选择:小团队主干开发加短分支;多人协作增加发布分支与合并门禁。
5. 制品管理
- 版本号遵循语义化,第三方与自研制品统一规范;
- 制品保留按发布重要度分级,生产环境可回滚;
- 禁止手工上传覆盖制品,避免"同一个版本两种内容"。
6. 一个实际例子
多业务域数字化平台技术方案 的构建与交付:
- Java 服务多模块构建,Web 侧 Node 20 构建静态资源;
- 制品统一进入制品库,接口文档统一平台维护;
- 部署以 Docker 镜像为交付物,单节点起步,环境一致优先。
7. 常见误区
- 本地能构建、流水线不能,靠口头补步骤;
- 依赖不锁版本,每次构建结果不同;
- 制品没有版本或版本可覆盖,回滚无从下手;
- 流水线只做构建不做测试,门禁形同虚设。