构建
构建的目标:从源码到可复现、可追溯、可回滚的制品。
构建要可复现、可追溯、可回滚
| 目标 | 含义 | 检查方式 |
|---|---|---|
| 可复现 | 同一提交在任何机器上产出相同制品 | 固定依赖与运行时版本 |
| 可追溯 | 每个制品能对应到提交与变更 | 版本号关联 commit |
| 可回滚 | 出问题时能回到上一个可用版本 | 制品保留策略 |
构建先固定依赖、模块与运行时
- Java 侧用 Maven 统一管理依赖,父工程收敛版本;
- Node 侧用 Yarn 或 Npm,提交锁文件,避免版本漂移;
- 依赖统一走私有制品库或官方源,禁止来源不明的包;
- 同一能力不引入多套同类组件,减少排障面。
模块边界先于拆分:
- 多模块工程统一版本号,按交付单元打包;
- 构建脚本纳入版本管理,本地与流水线使用同一脚本;
- 使用构建缓存缩短时间,但缓存不能成为可复现性的依赖;
- 基础镜像与运行时版本固定,构建环境与应用环境一致。
门禁失败即阻断,不认「本地能过」
典型阶段:构建 → 测试 → 扫描 → 制品 → 发布。
| 阶段 | 要求 |
|---|---|
| 构建 | 失败即阻断,不允许"本地能过" |
| 测试 | 单元与接口测试作为门禁 |
| 扫描 | 依赖漏洞与代码规范检查 |
| 制品 | 上传制品库,记录版本与提交 |
| 发布 | 与运维流程衔接,保留回滚点 |
分支策略按团队规模选择:小团队主干开发加短分支;多人协作增加发布分支与合并门禁。
制品禁止手工覆盖
- 版本号遵循语义化,第三方与自研制品统一规范;
- 制品保留按发布重要度分级,生产环境可回滚;
- 禁止手工上传覆盖制品,避免"同一个版本两种内容"。
公开边界
本页只写公开的构建与发布判断,不包含内部流水线脚本、制品仓库地址与部署凭据。