CI/CD / 系统课时
分析项目交付需求
分析项目交付需求
本课把分散的技术与业务要求整理为可执行的交付基线,明确环境划分、质量门禁、发布节奏和风险控制标准,为后续流水线设计提供可验证的输入。
学习目标
- 识别影响 CI/CD 方案的核心需求维度
- 将模糊要求转换为可检查的交付标准
- 建立发布、回滚和权限控制的验收基线
建立项目交付画像
分析交付需求的重点不是罗列技术名词,而是回答“满足哪些条件才能发布”。应同时确认技术栈、运行环境、质量要求、发布频率和风险目标,并为每项要求指定负责人、判断标准和失败处理方式。
| 需求维度 | 需要确认的问题 | 最终产出 |
|---|---|---|
| 技术栈 | 使用什么语言、构建工具、运行时和部署平台 | 构建环境、依赖版本和启动方式 |
| 环境划分 | 测试、预生产和生产如何隔离 | 环境清单、配置来源和访问边界 |
| 质量要求 | 哪些检查失败时必须阻断发布 | 测试、覆盖率和安全扫描门禁 |
| 发布频率 | 按提交、按天还是按版本窗口发布 | 自动化程度、审批节点和通知方式 |
| 风险控制 | 发布异常后如何止损 | 回滚目标、恢复时限和责任人 |
需求必须能够被测量。例如,“保证代码质量”应改为“单元测试全部通过,关键模块覆盖率不低于 80%”;“能够快速恢复”应改为“生产异常后 10 分钟内恢复到上一稳定制品”。
固化机器可读基线
下面使用 JSON 保存交付要求。该文件既可以用于需求评审,也可以被脚本和流水线读取,避免设计文档与实际配置采用不同标准。
json
{
"project": "payment-service",
"stack": {
"runtime": "Java 21",
"buildTool": "Maven 3.9"
},
"environments": ["test", "staging", "production"],
"qualityGates": {
"unitTestsRequired": true,
"minimumCoveragePercent": 80,
"blockOnCriticalVulnerability": true
},
"release": {
"frequency": "weekly",
"productionApprovalRequired": true
},
"riskControls": {
"immutableArtifact": true,
"rollbackTarget": "previous-stable",
"recoveryTimeMinutes": 10
}
}该配置表示:测试失败、覆盖率不足或发现严重漏洞时阻断交付;生产发布需要人工审批;不同环境部署同一不可变制品;生产异常时回滚到上一稳定版本。
校验关键交付约束
将配置保存为 delivery-requirements.json,再创建以下校验脚本。示例只依赖 Python 标准库,可以直接运行。
python
import json
from pathlib import Path
config_path = Path("delivery-requirements.json")
config = json.loads(config_path.read_text(encoding="utf-8"))
# 顶层字段缺失时立即终止,避免流水线读取不完整配置。
required_keys = {
"project",
"stack",
"environments",
"qualityGates",
"release",
"riskControls",
}
missing = required_keys - config.keys()
if missing:
raise ValueError(f"缺少字段: {sorted(missing)}")
# 生产环境和恢复时限属于生产交付的最低约束。
if "production" not in config["environments"]:
raise ValueError("环境列表必须包含 production")
if config["riskControls"]["recoveryTimeMinutes"] <= 0:
raise ValueError("恢复时限必须大于 0")
coverage = config["qualityGates"]["minimumCoveragePercent"]
if not 0 <= coverage <= 100:
raise ValueError("覆盖率阈值必须在 0 到 100 之间")
print("交付需求基线校验通过")预期输出:
text
交付需求基线校验通过评审时还要确认每个环境是否具有明确的权限边界,每个质量门禁是否定义了失败动作,以及每次发布是否能够追溯到唯一提交和唯一制品。只有技术选型、触发条件和验收标准形成闭环,交付需求才算完整。
本课总结
- 交付需求必须转化为可验证的阈值、责任和失败动作
- 环境、质量、频率与风险目标共同决定流水线结构
- 机器可读基线可以减少评审结论与实际实施之间的偏差
下一课预告
下一课将基于这份交付基线,设计从代码提交、测试、构建、制品发布到生产部署的端到端流水线。
按自己的节奏,确认真正理解。