Files
dsh_shenxian/poc
admin 1d72e8f9c8 chore(web): 降级留痕 + 收尾 —— 静默失效改为可观测;picker 升 0.1.5 消漂移(档案 88 / T07)
- 【留痕】model-catalog 读不到目录:console.warn(每进程一次)+ 新增 catalogDiagnostics(),并把结果透出到 GET /api/me/model-providers 的 catalog 字段;plugin-compat 的 platformPkgCount()=0 同样告警一次 ⇒「功能没做」与「做了但读不到目录」从此**可区分**(这正是那个 P1 长期潜伏的原因)
- 【前端】插件 0.3.13:厂家目录不可读 / 为空时**如实提示**(含目录路径),不再静默给空列表
- 【消漂移】poc/workspace-scoped-picker 升 0.1.5 并重打包铺发 —— 两实例已装 0.1.5 且含按序探测的新代码(此前只改了源码、线上还是旧候选)
- 【文档】README 补 DSHS_PACKAGE_DIR / DSHS_COMPAT_ROOT / DSHS_PI_AI_DATA_DIR(逃生口此前**未在任何地方暴露**)
- 【回归】verify-dsh-install 扩到 6 组(含「读不到 ≠ 目录为空」的区分);verify-platform-admin-section 加 2 条断言(词典 284/284)
- 真环境回归:picker 在 /usr/local 仍 import OK(没把本来能用的改坏)|providers 39(端点回 38)|platformPkgCount 223
2026-09-14 04:52:35 +08:00
..

Phase 3 核心路径 PoC(不写业务代码)

🧭 ← 返回 README · 结论落地为:K8s 部署教程

对应内部设计稿 §7 的四项风险验证。不引入任何业务代码——全部用一次性 镜像(busybox / node / socat / CloudNativePG)验证基础设施假设。四项全部通过, 才允许进入 Phase 0 镜像化 / Phase 2/3 落地,避免 Phase 3 返工。

前置条件

  • 一个 k3s 集群(k3s --cluster-init 3 server + N worker 皆可,单机 k3s 也能跑 PoC)。
  • 已装且健康:
    • Longhorn(item 1、4 依赖;item 1 是硬前提,必须 longhorn.io StorageClass 可用)
    • Cilium(item 3 依赖;NetworkPolicy 必须被强制)
    • CloudNativePG operator(item 4 依赖)
    • cert-manager / MetalLB / kube-vip 与本 PoC 无关,暂不需要
  • kubectl 指向该集群(kubectl get nodes 有输出)。
  • 本地有 bash + curl(item 2/3 用);item 2 的 WS 客户端用 node(本机或容器内均可)。
kubectl get nodes
kubectl get storageclass longhorn        # item 1/4 前提
kubectl get pods -n kube-system -o wide | grep -E 'cilium|longhorn|csi'
kubectl get crd clusters.postgresql.cnpg.io  # item 4 前提

Item 1 — Longhorn RWX + subPath + runAsUser/fsGroup(§4.9 / §6.0 的 PoC)

验证的未知点:fsGroup 是否会 chown subPath 叶子?非 root 目标 uid 能否在 PVC 根建目录、0700 属主是否正确、子目录挂载后能否读写。

⚠️ 这是 docs/k8s.md §4.9 标明的「PoC 第一项必须验证」。若失败,按 §4.9 的 回退:bootstrap 阶段用特权 Job 完成 chmod 1777(在启 PSA restricted 之前), 时序固定为「初始化 PVC → 启 PSA → 允许用户 Pod」。

cd 01-longhorn-subpath
./run.sh

通过标准(脚本自动断言):

  1. bootstrap Job(特权)chmod 1777 /mnt 成功。
  2. init Job(非 root,runAsUser/fsGroup = 100001)能 mkdir -p /mnt/u1/{ws,home} 且 chmod 0700 /mnt/u1 成功——即非 root uid 能写 PVC 根(chmod 1777 生效)。
  3. 测试 Pod(runAsUser=100001,subPath: u1)能写/读文件,且 stat 显示目录属主 uid=100001、权限 0700。
  4. (可选)另一个 uid(100002)无法读该目录——subPath 叶子 + DAC 的越权边界。

Item 2 — socat 桥 WebSocket 透明转发(§3.2 / §4.3)

验证的未知点:DSH 只监听 loopback,socat TCP-LISTEN:8081 → 127.0.0.1:8080 的纯 TCP 转发对 WebSocket Upgrade 是否透明。

cd 02-socat-ws
./run.sh

通过标准:

  1. 通过 sidecar 的 8081 能拿到 fake-dsh 的 HTTP 200(TCP 基础通)。
  2. WebSocket Upgrade 握手经 8081 返回 101 Switching Protocols,且 Sec-WebSocket-Accept 校验正确(证明 Upgrade 请求与响应都原样穿透 socat)。
  3. 一条文本帧 echo 往返成功(双向透明)。

若 2/3 不透明,回退:换 nginx/netcat sidecar(同端口转发),见 §9。


Item 3 — NetworkPolicy 默认拒绝 + 控制面→DSH 单向(§3.5 / §4.4)

验证的未知点:Cilium 是否强制 NetworkPolicy;default-deny 下「仅控制面可达 DSH 8081」的单向放行是否正确,跨来源访问被拒。

cd 03-networkpolicy
./run.sh

通过标准:

  1. 同 namespace 内打了 app=dsh-orchestrator 的「控制面」Pod 能连通 DSH 8081。
  2. 同 namespace 内其它 Pod(app=attacker)访问 DSH 8081 被拒(超时/拒绝)。
  3. 这也覆盖 §3.5 的「每次 NetworkPolicy 变更后跑自动化验证」——本脚本即该验证的雏形。

若 flannel(k3s 默认)下 2 仍通,说明 CNI 未强制策略,必须切 Cilium(§11.2)。


Item 4 — CloudNativePG on Longhorn 的 pgbench 基线(§4.5)

验证的未知点:Postgres 对延迟/IOPS 敏感,Longhorn RWO 复制是否拖慢同步复制, 延迟是否可接受。

cd 04-cnpg-pgbench
./run.sh

通过标准(人工判读,无固定阈值,取决于硬件):

  1. CloudNativePG 3 实例主备建立、Ready。
  2. pgbench -S(select-only)tps 与延迟与本机 NVMe 基线对比,落在可接受区间。 §4.5 结论:不够则回退「节点本地 NVMe + PG 主备」。

通过后

四项全过 → 记录结果(tps/latency 数字、Longhorn 权限行为结论)到本 README 尾部, 再进入 Phase 0(镜像化)。任一项失败 → 按对应 §9 回退方案调整后重跑。