Table of Contents

宿主内核运行架构

KernLab.Cell:宿主侧内核——把"管一批容器进程"拆成四个可组合的件:装载管线、监督状态机、 资源执法、通道。全部面向使用方暴露为 C# API,无 daemon、无配置文件。

运行总览

CellLoadPipeline.StartAsync
  └─ spawn(dotnet KernLab.Cell.Runtime.dll --pack … --startup …)
       └─ 容器自报端点(stdout:CELL_ENDPOINT=tcp:127.0.0.1:xxxxx)
            └─ 握手三步(Hello / HelloAck / Ready)
                 └─ 入池(CellSpec 全值分键)
                      └─ 服务:InvokeAsync / 回调 / 遥测
                           └─ drain(Bye → 在途收尾 → 容器退出码 0)

一代容器一条生命周期:包集变更=新世代新容器(RotateGenerationAsync——新容器 Ready 后旧容器 drain 退场),容器内热升级不做。

监督状态机

容器在监督器里是五态单写者泵:

Spawning ──握手三步──► Ready ──► Draining ──► Retired
   │                     │          ▲
   │ 装载失败/握手失败     │ 通道断/心跳失联│ 使用方发起 drain
   ▼                     ▼          │
 Faulted ◄────────────────┘

故障谱系四行——"活着但不干活"与"死了"是两种故障,检测手段与响应路径都不同:

故障形态 检测 响应
崩溃(进程消失) 通道断开+退出码 通道断=fail-fast,容器进 Faulted
挂死(活着但不干活) deadline 到期+心跳缺续累积 失联判定 → Faulted → 使用方决定 kill+替补
慢(劣化) deadline 命中率+队列水位计数 结构化事件暴露——降档/换容器决策归使用方
资源超限 OS 执法(见下) 同崩溃路径;事件带 OS 终止原因

资源执法

CellResourceDeclaration(内存 / CPU 配额 / 进程数)在 spawn 时翻译为 cgroup v2(Linux)/ JobObject(Windows)——执法者是操作系统:超限即被杀或限流,宿主代码不做软件配额、不预判。

诚实边界

三条边界不代劳、不伪造,使用方据此设计自己的策略:

  • 进程 ≠ 沙箱——Cell 给的是崩溃隔离与资源边界,不是安全边界;
  • 在途结果未知——容器死亡时在途调用可能已生效,重试/补偿语义归使用方;
  • 重启策略归使用方——Cell 只暴露状态与事件,退避/熔断是使用方的领域。

怎么用

var spec = new CellSpec("tenant-42", ["pack.echo"], generation: 0);
var (process, channel, ready) = await CellLoadPipeline.StartAsync(spec, options);

// 事件面:状态迁移/退出码/stderr 摘录都以结构化事件交使用方
process.Exited += code => Console.WriteLine($"container exit: {code}");
  • 资源档随 CellProcessStartOptions.ResourceLimits 声明;
  • 孤儿防护内建:容器 --parent-pid 轮询,父死自杀(实测 ≈1s 内,退出码 0);
  • 容器 stderr 尾 60 行常驻可取(process.StderrTail)——黑盒的唯一窗口。

反模式

症状 为什么错 正确形态
复用一个容器跑多租户混合包集 spec 分键失效——爆炸半径与资源核算全被破坏 一租户一 spec,包集变更=新世代
捕获 Faulted 后无限自动重启 重启风暴是使用方策略缺陷,不是容器故障 退避/熔断在使用方策略层实现
绕过装载管线直接 kill+重拉 池状态与监督状态机失同步 用 RotateGenerationAsync / 事件驱动替补

想深入