diff --git a/docs/VALIDATION.md b/docs/VALIDATION.md index b28b56fc..ffe2b6aa 100644 --- a/docs/VALIDATION.md +++ b/docs/VALIDATION.md @@ -546,3 +546,25 @@ build path / key marker scan: 未发现本机用户路径、临时构建目录 validation: 源码测试见上方同一源码提交记录;构建后再次核对 file、go version -m、ELF dynamic section、GLIBC version references、SHA-256 和敏感字符串 live deployment: 未执行;产物尚未在真实 Linux/libvirt 宿主机运行,未替换线上 Agent 或重启服务 ``` + +### 2026-10-18 VM 删除分阶段恢复与 Linux AMD64 构建验收 + +```text +source commit: 2d0305d5dd82b904581f6c66393cc53e0381d9b6 +delete stages: 普通删除只执行 graceful_shutdown;确认等待结束仍活动才返回 force_required;force_delete 使用独立 operation ID 和 ack_data_loss=true;inactive 后才进入 cleanup;自动核对永不把 graceful 或 uncertain force 升级为 Destroy +delete evidence: 删除前失败关闭地核对 managed-save、原生 snapshot/checkpoint、外部 snapshot/revertDisks/snapshotDeleteInProgress、实际 NVRAM、卷与过滤器的当前及历史引用;首次删除与 reconcile 共用 Domain、卷、Seed、过滤器、NVRAM 和流量状态的最终 absence 检查 +recovery bounds: Agent 自动核对默认最多 24 次或 6 小时,面板最多 12 次或 6 小时;到限进入 needs_attention 并退出普通 worker,但 resource blocker 继续阻止同 VM、卷、过滤器和目录资源的冲突操作 +crash recovery: ShutdownFlags 派发边界崩溃后,fresh admission-bound inspection 将仍活动的旧 graceful operation 结案为 graceful_shutdown_unconfirmed,只允许新 operation 重新正常关机;已授权 force 的结果丢失且 Domain 仍活动时,只能由超级管理员 token 二次核对确认旧 force 失败,随后再次 ack_data_loss 并创建新的 force operation;dispatching 和晚到结果不能被旧 token 覆盖 +administrator semantics: 立即核对保持只读;停止自动核对不表示底层调用停止;AbortJob 只用于匹配的在线 push backup;清理残留需要 token/plan 二次确认;网页仅显示白名单错误码的固定中文提示和 operation ID +Go validation: go mod verify、go mod tidy -diff、gofmt、git diff --check 通过;默认、libvirt、libvirt+libvirt_dlopen 三套 go test -count=1 ./... 与 go vet ./... 通过;libvirt+libvirt_dlopen 的 hypervisor/operation/api race 通过;macOS 链接器仅报告重复 libvirt/dl 库 warning +PHP validation: tests/*Test.php 125/125 通过;app/config/public/tests 下 405 个 PHP 文件逐一 php -l 通过;覆盖正常关机崩溃重试、强制删除二次授权、账本保留、管理员 token 核对、needs_attention 与错误白名单 +Node validation: 5/5 个 mjs 行为测试通过;public/resources 下 89 个 JavaScript 文件 node --check 通过 +review: 两轮独立终审均未发现剩余 HIGH/MEDIUM;已知低风险为 CloudWorkerService 终态事务与部分管理员事务的 job/instance 行锁顺序不同,极端同任务并发可能触发数据库可重试死锁,但事务回滚、租约和 blocker 会保留一致状态,不会重复 Destroy 或释放账本 +upgrade: 无面板数据库迁移;Agent bbolt journal 从 schema v2/v3 自动事务升级到 v4 并回填 recovery/resource-blocker 索引;部署需同步面板 PHP、静态资源与本次 Agent +toolchain: Go 1.27.1 / Zig 0.17.0;macOS arm64 交叉编译 linux/amd64,GOAMD64=v1;CGO_ENABLED=1;tags=libvirt,libvirt_dlopen;target=x86_64-linux-gnu.2.14;trimpath;ldflags='-s -w -linkmode external -extldflags=-s' +Agent artifact: release/virt-agent-linux-amd64 (10885744 bytes) +Agent SHA-256: 816fc90ca85bb2efef0bcabcab1049fc3160175b771a26fe5c7f93c67d186636 +artifact inspection: stripped ELF 64-bit x86-64;revision=2d0305d5dd82b904581f6c66393cc53e0381d9b6;vcs.modified=false;最高 GLIBC 符号版本 2.14;动态依赖 libc/libresolv/libpthread/libdl,运行时通过 dlopen 需要 libvirt.so.0 +build path / key marker scan: 未发现本机用户路径、临时构建目录、私钥标记或项目 Git 远端;临时目录产物与 release 文件逐字节一致 +live deployment: 未执行;未替换线上 Agent、重启服务、修改宿主机配置、操作真实 VM 或修改生产数据库 +``` diff --git a/release/virt-agent-linux-amd64 b/release/virt-agent-linux-amd64 index a6f64c7c..e9cfbaf9 100755 Binary files a/release/virt-agent-linux-amd64 and b/release/virt-agent-linux-amd64 differ