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
交付需求基线校验通过

评审时还要确认每个环境是否具有明确的权限边界,每个质量门禁是否定义了失败动作,以及每次发布是否能够追溯到唯一提交和唯一制品。只有技术选型、触发条件和验收标准形成闭环,交付需求才算完整。

本课总结

  • 交付需求必须转化为可验证的阈值、责任和失败动作
  • 环境、质量、频率与风险目标共同决定流水线结构
  • 机器可读基线可以减少评审结论与实际实施之间的偏差

下一课预告

下一课将基于这份交付基线,设计从代码提交、测试、构建、制品发布到生产部署的端到端流水线。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

分析项目交付需求

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通