feat(chv-muse-p1): 常驻 VM + WarmPool 扶正 + 气球 + vsock,对齐 Muse

每用户一台常驻 VM(暂停态,resume 到 SSH 5 秒内为待验证目标),
池空/失败回落冷启动;CHV 配置加 virtio-balloon + free-page-reporting
与 vsock notify 最小实现(SSH 仍是命令通道与就绪判定)。
新模块 resident_pool.py / vsock.py + 客内 vsock_notify.py;
_config 增加 CHV_RESIDENT_IDLE_MINUTES / CHV_BALLOON / CHV_VSOCK;
worker_adapter 接常驻孤儿清理 facade;ADR-17 差距表见
docs/chv-muse-p1-gap.md。

恢复收尾(分离后回归,见 gap.md §4):VmDeathTest 死亡模拟改杀
实际跑命令的 VM;两处冷路径旧测试显式关常驻;_balloon_vsock_payload
与 listen_notify 拆到 50 行内;resident_pool.py:208 mypy 修掉。
executor.py out 未注解与 marker_tools.py:142 是基线旧错,未动。

测试:全量 cloud 套件 1934 OK(skipped=8);mypy 在改动文件上
干净(仅基线旧错 4 处)。真机验证待第三棒让出 WSL 测试机。
This commit is contained in:
host committed 2026-11-06 21:31:48 +00:00
1 parent 06c3e172fe
commit 78098c5594
13 files changed
+2527 -36

No files matched your search

+61 -5
View File
@@ -259,6 +259,60 @@ def _gitea_fragment(env: dict) -> dict:
return {"gitea_sync_env": config_gitea_sync_env(env)}
def _to_switch(raw: object, name: str) -> bool | None:
"""CHV_* 开关解析(P1 气球/vsock 用):未设 → None(调用方
再定默认值);"1" 开、"0" 关;其它值一律 ValueError,绝不
静默当关(与 CHV_SSH_FORWARD 的 `== "1"` 旧口径不同,本轨
新开关按差距表要求非法值即报错)。"""
if raw is None:
return None
if raw == "1":
return True
if raw == "0":
return False
raise ValueError("%s 只能是 0 或 1:%r" % (name, raw))
def _balloon_vsock_fragment(env: dict) -> dict:
"""气球/vsock 片段(P1,feat-chv-muse-p1):virtio-balloon
+ free-page-reporting 开关、vsock notify 通道开关与客 CID。
- CHV_BALLOON:默认 1(开)。只认 "1"/"0",其它值
ValueError。
- CHV_VSOCK:默认 1(开)。只认 "1"/"0",其它值
ValueError。
- CHV_VSOCK_CID:客机 vsock CID,可选,默认 3。必须是
整数且在 3-4294967295 之间:0/1/2 是 vsock 保留 CID
(Hypervisor/Loopback/Host,CHV 的 VmConfig 校验会
以 VsockSpecialCid 拒绝),-1(随机 CID)CHV 的
vm.create 同样 400 拒绝(上游 discussion #7531),
所以这里不接受保留值/负值;显式设了非法 CID 即
ValueError,哪怕 CHV_VSOCK=0(配错早炸,不留到起 VM
才暴露)。CID 由运维指定、不是 CHV 分配的:同一宿主
上各 VM 的 vsock socket 文件不同,CID 相同(默认 3)
并不冲突。"""
balloon = _to_switch(env.get("CHV_BALLOON"), "CHV_BALLOON")
if balloon is None:
balloon = True
vsock = _to_switch(env.get("CHV_VSOCK"), "CHV_VSOCK")
if vsock is None:
vsock = True
raw_cid = env.get("CHV_VSOCK_CID")
if raw_cid is None:
vsock_cid = 3
else:
try:
vsock_cid = _to_int(raw_cid)
except ValueError:
raise ValueError("CHV_VSOCK_CID 必须是整数")
if not 3 <= vsock_cid <= 0xFFFFFFFF:
raise ValueError(
"CHV_VSOCK_CID 必须在 3-4294967295 之间:%s"
% vsock_cid)
return {"balloon": balloon, "vsock": vsock,
"vsock_cid": vsock_cid}
def _seed_fragment(params: dict, env: dict) -> dict:
"""seed 附加项片段:只存宿主文件路径,不读文件内容
(读文件在 wake 时 fail-closed,见执行器 _seed_extras;
@@ -295,17 +349,19 @@ def build_chv_config(params: dict, env: dict) -> "ChvConfig":
"""把显式构造参数与环境变量解析成 ChvConfig。
片段调用顺序即旧校验顺序(SSH → 配额 → 磁盘 →
超时),只有一处可观测的顺序变化:warm_pool_size
从旧超时片段移到配额片段,因此“CHV_WARM_POOL_SIZE
非法 + 磁盘非法同时出现”时先报前者;单项非法时
报错与旧代码逐字一致。字段集合与取值与旧代码一致,
由测试的字段集断言钉住。"""
气球/vsock → 超时),只有两处可观测的顺序变化:
warm_pool_size 从旧超时片段移到配额片段,因此
“CHV_WARM_POOL_SIZE 非法 + 磁盘非法同时出现”时先报
前者;单项非法时报错与旧代码逐字一致。字段集合 =
旧代码字段 + P1 气球/vsock 三字段(balloon/vsock/
vsock_cid),由测试的字段集断言钉住。"""
env = env if env is not None else {}
return _assemble_chv_config([
_base_fragment(params, env),
_ssh_fragment(params, env),
_quota_fragment(env),
_disk_fragment(env),
_balloon_vsock_fragment(env),
_network_fragment(params, env),
_timeout_fragment(params, env),
_gitea_fragment(env),