From 86fa8f60865b37fa0f45cf620eedd453dcaa0494 Mon Sep 17 00:00:00 2001 From: admin Date: Wed, 14 Oct 2026 21:56:38 +0800 Subject: [PATCH] docs(vpc): record production recovery --- docs/VALIDATION.md | 26 ++++++++++++++++++++++---- docs/VPC_DATAPLANE_ACCEPTANCE.md | 22 ++++++++++++++++++++++ docs/知识库/Memory/CURRENT.md | 17 ++++++++++++++--- 3 files changed, 58 insertions(+), 7 deletions(-) diff --git a/docs/VALIDATION.md b/docs/VALIDATION.md index 8e4f687b..5272a72e 100644 --- a/docs/VALIDATION.md +++ b/docs/VALIDATION.md @@ -43,10 +43,28 @@ 影响新实例公网地址分配,应单独修复;它们不进入本次已有实例的 VPC 私网加入路径, 六项均不是现场 rollback 的触发点。因此本轮不宣称全项目测试全绿,真实 helper/Fabric 回读仍是发布门禁。 -- 本节当前记录源码与本地回归,尚未提交、部署或重放网络写请求。部署后先显式核对 - 原 Fabric 并确认两台宿主 v4/helper、peer/overlay、route 和 nft exact;随后只对 - 原 VPC operation 执行一次显式“重新核对”。只有宿主 state、WireGuard、nft、 - libvirt XML/seed、QGA `/32` 和真实跨宿主流量全部通过,才能记录现场恢复。 +- 修复提交 `7fe16eef4d098654bb43fc9c033415e335b5b36b` 已推送到 `origin/venix`,并由 + durable updater 任务 `quUOSHlnVbyXaKlEyf76F6Ee` 部署到同一提交;任务完成于 + `services_ready`,回滚引用为 `refs/virt-cloud/rollback/1791984952-9c4e9b9d`, + 部署后面板、Engine 和 worker 均为 active。七个无 operation、无资源的历史 + uncertain claim 继续原样保留;更新任务只使用维护接纳旁路,没有据此删除旧 claim。 +- Fabric 原计划经 operation `346f3a8124654ef9830ba81518524f1a` 显式核对,两台宿主 + 都完成 v4 helper 和完整回读,readiness 为 2/2。随后只核对原 VPC operation + `708fa7c660383d7ee945d1543de1e0a8`,未创建第二个加入任务。revision 3 在两台 + 宿主均 exact:Debian 保存本地 `10.0.2.1/32` 与远端 `10.0.2.2/32`,AlmaLinux + 保存本地 `10.0.2.2/32` 与远端 `10.0.2.1/32`,bridge、`wg-fabric0` route、peer + 和 nft 归属一致。 +- `vm-c922py` 正常关机后,原 operation 把 `ua-private0` 持久网卡写入 bridge + `vcv-a8afbea1016`。第一次启动恰逢 Engine 随更新重启,网关返回 502;在宿主确认 + 实例仍为 shutoff、同一启动 operation 已收敛为 failed 后才重新提交一次。启动后 + live XML 显示私网 MAC `56:76:17:37:60:e3` 连接该 bridge,QGA 回读 `enp6s0` + 为 `10.0.2.2/32`。原 VPC operation 最终为 succeeded、`evidence_version=2`;VPC + 为 `active/applied`、desired/observed revision 均为 3、两条宿主 deployment 均 + active,页面显示 3/3 active、0 项需处理。 +- 从 `vm-c922py` 通过 QGA 执行 `ping -c 3 -W 1 10.0.2.1`,guest-exec 终态为 + `exited=true, exitcode=0`,证明本次两台宿主之间请求与回包的数据路径已通。本轮通过 + 当前 VPC、两台指定宿主和两个成员的上线验收;宿主重启、故障注入、规模与完整正反 + 流量矩阵仍是更广的验收范围,不能由这次成功替代。 ## 2026-10-14:Fabric 旧未决占用阻断显式核对 diff --git a/docs/VPC_DATAPLANE_ACCEPTANCE.md b/docs/VPC_DATAPLANE_ACCEPTANCE.md index b77ca747..02770e15 100644 --- a/docs/VPC_DATAPLANE_ACCEPTANCE.md +++ b/docs/VPC_DATAPLANE_ACCEPTANCE.md @@ -4,6 +4,28 @@ 语法和 typed readback contract。当前开发环境没有 `ip`、`wg`、`nft`、`nmcli`、 `ifquery` 或 libvirt daemon,因此下面的宿主机步骤不能在本机冒充通过。 +## 2026-10-14 当前生产实例验收证据 + +- `venix` 修复提交 `7fe16eef4d098654bb43fc9c033415e335b5b36b` 已完成 durable + update 并进入 `services_ready`。Fabric 核对 operation + `346f3a8124654ef9830ba81518524f1a` 在 Debian 与 AlmaLinux 两台宿主均成功, + helper v4、peer/overlay、route 和 nft 完整回读为 exact,地区 readiness 为 2/2。 +- VPC `dd` 保留原加入 operation `708fa7c660383d7ee945d1543de1e0a8`,没有重建或 + 重放加入请求。revision 3 在两侧 state 中各自仅保存 route-backed peer 贡献: + Debian 本地/远端为 `10.0.2.1/32`、`10.0.2.2/32`,AlmaLinux 本地/远端相反; + Debian table 16606、两侧 bridge 与 `wg-fabric0` 路由均与 state 一致。 +- 新成员 `vm-c922py` 经过正常关机、同一 operation 核对和一次安全开机后,persistent + 与 live XML 均有 `ua-private0`,私网 MAC `56:76:17:37:60:e3` 连接 bridge + `vcv-a8afbea1016`;QGA 在同一 MAC 的 `enp6s0` 回读唯一 `10.0.2.2/32`。首次开机 + 请求与部署重启重叠而返回 502,先确认该 operation 已 failed 且宿主仍 shutoff, + 才重新提交一次,没有把未知写结果直接重放。 +- 原 VPC operation 最终为 succeeded、`evidence_version=2`;VPC 为 + `active/applied`、desired/observed revision 均为 3,两条宿主 deployment 都是 + active,页面显示 3/3 active、0 项需处理。从 `vm-c922py` 经 QGA 向另一成员 + `10.0.2.1` 发出三次 ICMP,guest-exec 以 `exitcode=0` 结束,证明请求与回包路径可用。 +- 以上只确认这个 VPC、两台宿主和两个成员的当前闭环。重启、reload、故障注入、 + MTU/NAT、ACL 负向和规模场景仍应按下方矩阵单独验收。 + ## 应用前证据 在每台同地区宿主机保存 Fabric `active` 的新鲜回读,并确认: diff --git a/docs/知识库/Memory/CURRENT.md b/docs/知识库/Memory/CURRENT.md index bd2ac13e..c5ba46c9 100644 --- a/docs/知识库/Memory/CURRENT.md +++ b/docs/知识库/Memory/CURRENT.md @@ -40,9 +40,20 @@ tags: 回归;18 个相关模块 1,234 passed,完整 Engine 为 3,975 passed、24 skipped、 118 subtests passed、6 failed。六个失败均在未修改 `9fb2624` 复现:三项是旧测试 漂移,另三项是既有公网池占用扫描/耗尽判断缺陷;后者会影响新实例公网地址分配, - 但不进入本次已有实例的 VPC 私网加入路径,详见 `docs/VALIDATION.md`。源码验证不 - 代替 helper v4、两宿主 state/WG/nft、libvirt XML、seed、QGA 和来宾私网实流量 - 验收。本节当前仍待提交、部署并以原 operation 完成现场核对。 + 但不进入本次已有实例的 VPC 私网加入路径,详见 `docs/VALIDATION.md`。公网池缺陷 + 仍须另行修复,不能因本次私网恢复而视为已通过。 +- **部署与现场闭环**:修复提交 `7fe16eef4d098654bb43fc9c033415e335b5b36b` + 已推送并由 durable updater 部署到同一提交,终态为 `services_ready`。Fabric + operation `346f3a8124654ef9830ba81518524f1a` 在两台宿主均成功并达到 readiness 2/2; + 只对原 VPC operation `708fa7c660383d7ee945d1543de1e0a8` 做显式核对,没有创建 + 新的加入任务。两侧 revision 3 state、WireGuard peer/route、bridge 和 nft exact。 +- **实例与流量证据**:`vm-c922py` 关机后由原 operation 写入持久 `ua-private0`, + 安全启动后 live 网卡连接 `vcv-a8afbea1016`,QGA 回读 `10.0.2.2/32`。部署重启窗口 + 内第一次启动曾返回 502;先确认对应 operation 终态 failed 且宿主仍 shutoff,才 + 重试一次。原 VPC operation 最终 succeeded、`evidence_version=2`,VPC 与两条宿主 + deployment 均 active,页面为 3/3 active。该实例向另一宿主成员 `10.0.2.1` 的 + 三次 ICMP 由 QGA guest-exec 以 `exitcode=0` 结束。这里只完成当前双宿主 VPC 的 + 现场闭环,不替代重启、故障注入和完整 ACL/规模矩阵。 - 详细迁移与验收见 `docs/VALIDATION.md`、`docs/VPC_DATAPLANE_ACCEPTANCE.md`; 关系沿用 [[Concepts/Virt Cloud WireGuard Fabric与VPC L3私网]] 与 [[Concepts/Virt Cloud VPC永久邻居与重复协调]]。