主题
XHIM Capacity Qualification Report
Status: NOT EXECUTED — RELEASE BLOCKED
本文件不是容量结论。仓库已经提供固定的四阶段容量计划、故障注入项、证据 Schema、报告生成器和失败门禁;当前工作区没有独立压测环境、监控数据和 24 小时运行结果,因此不能填写任何吞吐或 SLO 数字。
正式执行时复制 server/load/capacity-evidence.template.json 到发布证据目录, 但不要修改仓库内模板。证据 Schema v3 必须同时绑定:
- 完整 40 位源码 Commit、发布 SemVer 和原始
capacity-plan.json的 SHA-256; - 真实部署环境,以及其规范化 JSON SHA-256 和不可变部署版本;
capacity-config/下的部署、限额、拓扑和负载生成器配置;- 校准、目标负载、双倍目标负载和 24 小时稳定性每一阶段的独立原始结果;
- 计划要求的每个故障演练的本地原始结果;
- 与执行人不同的审批人和可追踪审批编号。
配置和原始结果必须先放进同一个证据根,使用安全相对路径并记录文件 SHA-256。外部 URL、符号链接、目录穿越、缺失文件、重复阶段结果、未引用的 监控文件、模板值、空指标、NaN/Infinity、错误 Hash 或 not_run 都会使门禁 失败。
下面的命令只在真实数据填写完成后执行;验证回执路径必须尚不存在:
bash
version=1.2.3
commit=0123456789abcdef0123456789abcdef01234567
evidence_root=/absolute/path/to/xhim-capacity-evidence
python3 scripts/reporting/verify_capacity_report.py \
server/load/capacity-plan.json \
"${evidence_root}/capacity-evidence.json" \
--version "${version}" \
--commit "${commit}" \
--artifact-root "${evidence_root}" \
--verification-output \
"${evidence_root}/capacity-verification.json"
python3 scripts/reporting/render_capacity_report.py \
"${evidence_root}/capacity-evidence.json" \
"${evidence_root}/capacity-report.md" \
--plan server/load/capacity-plan.json \
--verification "${evidence_root}/capacity-verification.json" \
--artifact-root "${evidence_root}"只有验证器成功产生、且精确绑定计划、证据、环境、配置集和原始结果集 Hash 的 回执,报告才会显示 VERIFIED PASS。不传回执时,即使手工把指标改成 passed,渲染器也只会生成 UNVERIFIED — NOT FOR RELEASE。仓库中的本页会 一直保持 NOT EXECUTED — RELEASE BLOCKED,真实版本报告应作为该版本的独立、 签名发布证据保存。