宿主内核运行架构
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 / 事件驱动替补 |