Skip to content

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,真实版本报告应作为该版本的独立、 签名发布证据保存。

XHIM 客户端 SDK 与服务端文档