PROJECT-MAP — lsf_ins 项目地图¶
接任务先查第 1 节任务路由表；问现状去 HANDOFF.md；问步骤去 SOP.md / RUNBOOK.md。 本文件是静态结构视图（工程身份与依赖），不记现状与待办。更新方式为定点修订（只改受影响行），不整体重写。
1. 任务路由表¶
| 任务 / 症状 | 去哪个工程 | 先读 | 入口命令 |
|---|---|---|---|
| 部署 / 幂等复跑 / 漂移 | deploy/lsf/ |
HANDOFF 第 1 节 → BASELINE 第 2 节 | cd deploy/lsf && .venv/bin/python main.py -c config/lsf_deploy.yaml（--precheck / --drift / --dry-run / --rollback） |
| 接入 / 核对 submit 节点 | submit_node/ |
submit_node/SOP.md |
... --stage submit |
| 主备切换演练 | docs/SOP.md 第九章 |
docs/RUNBOOK.md |
... --failover-test |
作业级 TMPDIR / 本地 scratch |
local_scratch/、tmpdir_inject_20261008/ |
各自 SOP.md |
... --stage local-scratch（高危） |
| cgroup | cgroup_v1/ |
cgroup_v1/SOP.md + BASELINE 第 4 节 |
... --stage cgroup（含重启） |
| FP15 升级 | fp15_upgrade/ |
fp15_upgrade/SOP.md |
按该 SOP（介质前置） |
| 日常启停 / 监控 / 故障处置 / 凭据轮换 | docs/RUNBOOK.md |
RUNBOOK | — |
| 历史故障根因 | docs/INCIDENT-20260924-部署期故障排障台账.md |
INCIDENT 台账 | — |
| 探测批量化（工程侧四轮 + 共享库） | lsf_probe_batch_20261007/、lsf_probe_batch2_20261007/、lsf_probe_batch3_20261007/、shared_precheck_batch_20261007/、probe_batch4_20261008/ |
各 SOP.md |
— |
| master 排除计算 | master_noexec/ |
master_noexec/SOP.md |
— |
/projects 纳管 |
projects_mount/ |
projects_mount/SOP.md |
— |
| LSF 仿真怎么用（队列 / 模块 / 存储） | 全局技能 lsf-simulation-env |
该技能 SKILL.md |
— |
2. 分层依赖图¶
【物理层】KVM 宿主 → 6 台 Rocky 9 虚机：lsf-master-01/02 · lsf-work-01~03 · hpc-submit
│
【服务层】NFS(/data/nfs/lsf) · LDAP(sssd) · LSF daemons(lsfd/lim/res/sbatchd) · lsf-health / lsf-user-sync timer
│
【存储层】/projects(NFS) · /local_scratch(节点本地) · /mnt/lustre(归 lustre 项目) · 作业 $TMPDIR → /local_scratch/users
│
【实现层】deploy/lsf/（唯一 Python 部署器：13 阶段 + cgroup / failover / submit / local-scratch 四个独立阶段）
│ └─ 依赖共享库 ~/py_public_modules/（base_module · precheck_module · paramiko_module）
│
【入口层】bsub/bjobs 提交（管理员 · LDAP 用户 · root）· main.py CLI（precheck / drift / rollback）
3. 子项目卡片¶
活工程
| 工程 | 定位 | 关键产物与入口 | 上下游 |
|---|---|---|---|
deploy/lsf/ |
LSF Suite CE 集群部署器（唯一实现体） | main.py（13 阶段 + 4 独立阶段；precheck / drift / rollback CLI）· config/lsf_deploy.yaml · credentials.yaml(600) |
依赖共享库 ~/py_public_modules/；配置改 lsf.cluster.* / lsb.* |
服务档案（docs/）
| 文件 | 定位 | 上下游 |
|---|---|---|
docs/HANDOFF.md |
交接快照（现状 / 待办 / 红线 / 指针），会话注入 | 指向 BASELINE / PROJECT-MAP / SOP / RUNBOOK |
docs/BASELINE.md |
稳定层（环境事实 / 命令速查 / 文档地图 / 已定不做） | 被 HANDOFF 引用 |
docs/SOP.md |
变更档案（首轮八章 + 第九~十四章） | 各主题 SOP 的总汇 |
docs/RUNBOOK.md |
日常运维手册 | — |
docs/INCIDENT-20260924-部署期故障排障台账.md |
事故与排障台账 | 原 SOP 附录A 单列 |
docs/backup/README.md |
docs 备份台账 | — |
留档（已闭环变更档案，只读；退役不删目录）
| 主题目录 | 记录 |
|---|---|
cgroup_v1/ |
cgroup v1 切换方案、执行结果与根因 |
local_scratch/ |
阶段15：宿主 KVM 加虚盘 + 节点 xfs 挂载 |
tmpdir_inject_20261008/ |
作业级 TMPDIR 注入本地 scratch |
projects_mount/ |
/projects 纳入阶段1 受管挂载 |
submit_node/ |
submit 节点接入（eauth / keyscan 踩坑） |
master_noexec/ |
两台 master 排除计算 + 部署器化 |
lsf_probe_batch_20261007/ · lsf_probe_batch2_20261007/ · lsf_probe_batch3_20261007/ |
部署器只读探测批量化（工程侧四轮） |
shared_precheck_batch_20261007/ |
共享库 precheck_module 批量化 |
probe_batch4_20261008/ |
建连数自报 + 交付文档复核 + disks 批量化判不做 |
fp15_upgrade/ |
FP15 升级方案（含 install.config / 平台目录改造、回滚与备份台账） |
数据源
| 目录 | 定位 |
|---|---|
IBM_Spectrum_LSF/ |
LSF 安装介质 |
4. 工程命名与文档约定¶
- 主题目录命名：
<主题>_<YYYYMMDD>/（如tmpdir_inject_20261008/）；内含SOP.md+backup/README.md（备份台账）+ 对照件。 - docs 三件套：
HANDOFF.md（现状，会话注入）·BASELINE.md（稳定层，不注入）·SOP.md（变更档案）；另加RUNBOOK.md（运维）与INCIDENT-*.md（事故）。 - 工程形态：复杂 / 多主机变更一律以 Python 工程承载（本工程即
deploy/lsf/）；仅极简变更允许单文件 shell。 - 退役纪律：工程退役不删目录，只把身份标签改为「留档」。
来源：
/home/rain/Documents/LSF/lsf_ins/docs/PROJECT-MAP.md｜ 最后更新：2026-10-09 02:37（由build/sync.py同步，请勿在站点侧修改）