feat(tee): 固化真机双机重跑环境,补齐预检与症状速查,避免每次从零探索
核实结论:这两天 AMD / 海光真机测试内容**早已在仓库** —— 36 个脚本、
288 行复现 README、630 行 FINDINGS、nodes 真机路径样例、fixtures 真实
CSV/SNP 报告与证书链。真正导致「每次重跑重新拼」的只有三处缺口:
参数散在 5+ 个脚本头部、没有预检、踩坑结论按探索时间组织不好按症状查。
- 新增 real-machines.env.example:2026-11-08 证明门控 + 双 guest 会话合流
跑通那组值的脱敏快照。28 个变量与脚本 ${VAR:-default} 逐字一致(已自动
核对,无一处笔误);凭据只放 xop 键名;区分组级与编排层实例级变量,
运行时生成项明确标注「不要手填」。
- 新增 preflight-real-machine.sh:本地工具 / xop 键 / 参数一致性 / SSH /
远端物料一次性报缺;缺环境显式 SKIP 或 FAIL,不静默通过;
--self-test 用 6 个构造样例逐条破坏参数判据(7/7),证明非恒绿。
只查环境,不产生 TEE_PAIR_OK 之类业务结论。
- README 增「重跑前先看」:三步重跑、参数真相源、17 条症状→根因→处置
速查表、/tmp 60+ 探索脚本处置说明(过程产物,结论已沉淀,不许重跑确认)。
- INDEX §2/§3/§6 与 CLAUDE.md 登记;.gitignore 屏蔽本地实际 env 配置。
校验:bash -n、lint-shell-vars 33 脚本无隐患、预检自测 7/0、离线实跑
ok=15 SKIP=1 FAIL=0、判据零依赖自测 22/0、diff --check、路径与密钥扫描
全过。未改 tools/ci.sh,门禁条数仍为 22。
This commit is contained in:
1 parent
c51190b20c
commit
fc0dcec93b
6 files changed
+416
-4
No files matched your search
+12
-3
@@ -49,7 +49,8 @@
|
||||
| 跑真链验收 | `tools/selftest-fisco-contract.py`(`--self-test` 零依赖) | 自己拼交易;`fisco-realnode-probe.py`(历史契约,未销账) |
|
||||
| 查门禁条数 / 跑全量闸门 | `tools/ci.sh` | 任何文档里写的数字 |
|
||||
| 查链端点 / 链配置 | `tools/fisco-realnode/example.chain.json` + `deploy/k8s/fisco/README.md` | `127.0.0.1:20200`(旧本机容器,已停) |
|
||||
| 复现真机证明门控 | `deploy/tee/real-machine/README.md` | `docs/REAL_MACHINE_FINDINGS.md` 第 7/9 节的「当时边界」 |
|
||||
| 复现真机证明门控 | `deploy/tee/real-machine/README.md`(开头「重跑前先看」) | `docs/REAL_MACHINE_FINDINGS.md` 第 7/9 节的「当时边界」 |
|
||||
| 重跑真机双机 e2e:配置 / 预检 / 症状速查 | `deploy/tee/real-machine/real-machines.env.example` + `preflight-real-machine.sh` + 该 README 速查表 | 逐个脚本 export 参数;去 `/tmp` 翻 60+ 个探索脚本 |
|
||||
| 部署 / 回滚链节点 | `deploy/k8s/fisco/`(含 `migrate-ledger.sh`、`README.md`) | 手动 `docker start fisco-gm`(会与 k8s 链分叉) |
|
||||
| 看真链实证期的审计轨迹 | `tools/fisco-realnode/README.md` | `/tmp`(会被清) |
|
||||
| 查两台真机硬事实 / 踩坑 | `docs/REAL_MACHINE_FINDINGS.md`(第 10 节最新) | 记忆或口头结论 |
|
||||
@@ -98,7 +99,11 @@
|
||||
### D 部署与复现
|
||||
|
||||
`deploy/k8s/fisco/README.md`(链迁移 SOP / 账本 / 回滚 / 边界)、
|
||||
`deploy/tee/real-machine/README.md`(真机 e2e)、`deploy/tee/README.md`、
|
||||
`deploy/tee/real-machine/README.md`(真机 e2e;**开头有重跑三步、参数真相源与症状速查表**)、
|
||||
`deploy/tee/real-machine/real-machines.env.example`(**双机参数唯一集中入口**,脱敏、可 source)、
|
||||
`deploy/tee/real-machine/preflight-real-machine.sh`(重跑前环境预检,`--self-test` 负向矩阵)、
|
||||
`deploy/tee/real-machine/nodes/*.node.example` + `fixtures/`(真机路径与真实报告 / 证书链样本)、
|
||||
`deploy/tee/README.md`、
|
||||
`deploy/tee/oci/README.md`、`deploy/ray/README.md`、
|
||||
`demo/README.md`、`demo/k8s/README.md`(站点 + PVC)、
|
||||
`tools/fisco-realnode/README.md`(复现工具与审计轨迹)、
|
||||
@@ -164,4 +169,8 @@
|
||||
9. **架构结论只改 `docs/ARCHITECTURE_SYSTEM.md`**:新增 / 变更组件、边界、端点先改它,
|
||||
再跑 `python3 tools/render-share-html.py`(重新生成 `.html`)与 `--check`(校验同步)。
|
||||
HTML 是**派生产物不许手改**;历史决策文档正文不因架构变更而改写。
|
||||
文档里写「部署了什么」必须区分 [实证] 实证 / [桩验] 桩验 / [设计] 设计角色,不许把蓝图写成现状。
|
||||
文档里写「部署了什么」必须区分 [实证] / [桩验] / [设计] / [禁用],不许把蓝图写成现状。
|
||||
10. **真机参数只认 `deploy/tee/real-machine/real-machines.env.example`**:换机器 / 换网段
|
||||
改这一份,不要逐个脚本 export;重跑前先 `preflight-real-machine.sh`(`--self-test`
|
||||
用构造样例钉死参数判据非恒绿)。`/tmp` 的 60+ 个探索脚本是过程产物,结论已
|
||||
沉淀进验签器与 `REAL_MACHINE_FINDINGS.md`,**不许整批入库或重跑确认**。
|
||||
Reference in new issue
Block a user