HANDOFF — kvm_rocky9_deploy 交接快照¶
本文件经 SessionStart Hook 全文注入，供新会话直接接手。 档位：【已确认】有实测证据 ／【未验证】说法未经证实 ／【待决策】尚未定论。 只写「现在」；历史过程进各批次
SOP.md，环境事实／机制陷阱／命令速查／文档地图已拆到docs/BASELINE.md。 修订方式：定点修订（2026-10-07 刷新 centos7 状态与本轮变更要点；当前 ≤6 KB 目标内，稳定层已拆分）。
1. 这份文件怎么用¶
- 读完第 2、3 节即可接手：现在是什么状态、下一步做什么。
- 环境事实（地址段、存储池、路径、日志）、机制陷阱与命令速查见
docs/BASELINE.md，按需读取。 - 若本文件与实现体不一致，以实现体为准，并顺手修正本文件。
2. 当前状态¶
一句话：七个批次全部创建并验证通过——LSF 5 台、rocky9-01、harbor-01、CentOS 7 单台（临时测试机，2026-09-29 销毁后已于 2026-10-07 重建并跑通）。工具两个入口：Rocky 9 用 main.py、CentOS 7 用 main_centos7.py，共用同一进程锁与生命周期框架。
| 项 | 现状【已确认】 |
|---|---|
| 在跑域 | 22 台：openwrt 1、k8s 4（另 k8s-master-02/03 shut off）、slurm 5、lustre 2、lsf 5、rocky9-01、harbor-01、Flexlm、centos7-01 |
| harbor-01 | 2026-10-01 新建：4C/8G；50G 系统盘 + 200G 数据盘（均 qcow2 @ hdd-pool，数据盘挂 /data）；192.168.31.31 / 52:54:00:31:0f:01；running、autostart、drift=0、幂等 skipped |
| rocky9-01 | 8C/16G/50G HDD，192.168.31.28 / 52:54:00:31:0e:01，running、autostart、drift=0、幂等 skipped |
| centos7-01 | 2026-10-07 重建：2C/4G/30G qcow2 @ hdd-pool；192.168.31.30 / 52:54:00:31:10:01；running、autostart=false、幂等 skipped |
| 入口与 CLI | Rocky 9：main.py；CentOS 7：main_centos7.py。CLI 两者一致：--config --precheck --drift --dry-run --rollback --force --log-level |
| 幂等 | LSF、rocky9、harbor、centos7 批次复跑均 状态: skipped、零变更 |
| 宿主内存 | 117 GiB total，当前可用约 30 GiB（气球 + 稀疏分配兜底） |
本轮变更要点（2026-10-07）：复验 CentOS 7 建机墙钟并做小优化——deployer.py 把安装/就绪等待的轮询间隔由写死 15s 下沉为配置项 poll_interval_sec（默认 5），centos7 配置显式设 5。实测墙钟 599.30s → 530.51s，其中轮询下沉的确定贡献仅约 10s（1.7%），其余约 59s 系宿主负载导致的安装时长波动；墙钟 93% 由 CentOS 7 安装本身决定。另查明 2026-09-28 印象里的「很慢」实为两次失败空转（就绪探测 29 / 117 次后回滚，18 / 38 分钟），非正常创建慢。详见 centos7-perf-20261007/SOP.md。（前一轮 2026-10-01：新增 harbor-01、实现体未改、创建 812.79s。）
3. 未完成事项¶
| 事项 | 下一步 | 拾起位置 |
|---|---|---|
| 就绪失败空转 | _wait_for_ssh 在持续 pending（端口拒绝）时仍等满 2400s；2026-09-28 两次「很慢」由此产生。可评估「连续 N 次 pending 即提前失败并提示 virsh console」，属判定语义变更【待决策】 |
centos7-perf-20261007/SOP.md 附录 B |
| Harbor 本体安装 | 本次只交付基础系统。需装容器运行时（Docker/Podman）→ 部署 Harbor（4C/8G 起步，学习环境可关 Trivy）→ 配 HTTPS（自签）或 http，并在各节点信任该仓库【待决策】 | harbor-20261001/SOP.md 附录 B |
| LSF 软件安装 | 只交付了 Rocky 9 基础系统，LSF 安装与配置未做【待决策】 | 不属本工程范围；本工程只管建机 |
| CentOS 7 能力去留 | 建机能力（入口、子类、模板、配置）保留备用；若确定不再需要，按 SOP 第 7 章第 2 层删 5 个文件【待决策】 | centos7-20260928/SOP.md 第 7 章 |
| CentOS 7 EOL | 镜像为 7.1（1511），已 2024-06-30 EOL、无安全更新；不得承载长期业务【已确认】 | 同上 第 8 章风险表 |
| 改造遗留四项 | 环境契约 contract.yaml、bundle+manifest、批次失败阈值、执行通道 provider 抽象 |
lsf-20260924/SOP.md 附录 C |
| 历史文档 CLI 漂移 | 给 docs/SOP.md、docs/SOP-hosts-20260918.md 各加一行「CLI 已由 lsf-20260924/SOP.md 覆盖」 |
这两个文件 |
| 备份清理 | LSF、rocky9、centos7、harbor、centos7-perf 五处验证均已通过，可对照台账自行删除；Agent 不主动删 | 各批次 backup/README.md |
.28 / .31 DHCP 池 |
ping 均空闲【已确认】，但未向使用方确认不与路由器 DHCP 池冲突【未验证】 | 路由器 DHCP 配置 |
| flexlm 配置修复 | 改 name（如 flexlm-01）、ip（改前先重新确认真实空闲 IP）、credentials_file；改后 --precheck→--dry-run→执行（用户自行执行）【待决策】 |
config/flexlm-rocky.yaml、RUNBOOK 第 5.3 节 |
| 项目地图缺失 | 项目下已有 ≥3 个主题工程目录（lsf / rocky9 / centos7 / harbor / centos7-perf / runbook），按规范应有 docs/PROJECT-MAP.md（任务路由表 + 分层依赖 + 子项目卡片），当前缺失【待决策】 |
需新建 docs/PROJECT-MAP.md |
4. 红线¶
--rollback会销毁虚机与其磁盘，不可恢复；需--force或交互输入YES。预演（--dry-run --rollback）只列清单。- 所有模式必须以
sudo执行；漏sudo会在日志初始化阶段报PermissionError（业务逻辑未启动、无副作用，补sudo重跑即可），诊断见 RUNBOOK 第 8 章场景 6。 - 各批次（k8s、slurm、lustre、lsf、rocky9、centos7、harbor）的定义与磁盘互不影响；巡检/回滚只作用于所选配置里列出的主机。
- 不重启宿主、不改
br0/ 物理网卡 / netplan；宿主上若有调度作业，不得动该节点。 config/credentials*.yaml含明文 root 口令，已 gitignore，禁止提交或外传。utils/kvm_utils.py是共享能力层：改它之后须对全部配置各跑一次--drift回归；deployer.py为两入口共用，改它之后须对 Rocky 9 与 CentOS 7 各跑一次--dry-run回归。- 变更前先备份到当前主题的
backup/并登记台账。
5. 指针¶
| 文件 | 内容 |
|---|---|
docs/BASELINE.md |
稳定层：环境事实 / 机制陷阱 / 命令速查 / 文档地图（各批次 SOP、代码文件一览） |
runbook-20260925/RUNBOOK.md |
部署工具使用手册（12 章；日常使用与故障处置） |
centos7-perf-20261007/SOP.md |
2026-10-07 建机效率复验与轮询下沉（墙钟对照与归因） |
各批次 backup/README.md |
备份台账（lsf-20260924、rocky9-20260925、centos7-20260928、harbor-20261001、centos7-perf-20261007） |
来源：
/home/rain/Documents/kvm/kvm_rocky9_deploy/docs/HANDOFF.md｜ 最后更新：2026-10-07 21:25（由build/sync.py同步，请勿在站点侧修改）