容器内部
KernLab.Cell.Runtime:容器进程的引导器与运行时——一个真实子进程里发生什么。
进程画像
引导(解析 CLI)→ 绑定载体 → 自报端点(stdout 唯一输出)→ 装载 pack
→ 握手三步 → 服务循环(invoke / callback / telemetry)→ drain → 退出码 0
运行期致命(组装失败/未捕获异常)= stderr [cell] fatal: + 退出码 11。退出码只有 0 和 11,
运维归因单源。
CLI 契约
dotnet KernLab.Cell.Runtime.dll
--pack <dll> # 可多次;每个 pack 一个可回收程序集加载上下文
--startup <类型全名> # 必填——实现 ICellPackStartup;缺失即启动失败
--parent-pid <pid> # 孤儿防护:1s 轮询,父死自杀(退出码 0)
--mode dynamic|aot # 装载模式声明,缺省 dynamic
--carrier tcp|uds # 载体,缺省 tcp
--socket-dir <dir> # uds 套接字落点
--label <串> # 实例标签(握手防误连)
模式声明与运行时事实不符=启动失败(不自欺):--mode aot 下误配 --pack 动态装载=拒启;
NativeAOT 发布态声明 dynamic=拒启。
pack 与装载点
使用方实现 ICellPackStartup,Configure 里显式注册一切——零扫描:
public sealed class EchoStartup : ICellPackStartup
{
public void Configure(ICellPackBuilder packs)
{
packs.RegisterSite("app.echo", CellCodecIds.None,
static (payload, ct) => ValueTask.FromResult<ReadOnlyMemory<byte>>(payload.ToArray()));
packs.DeclareResource(new CellResourceDeclaration { MemoryBytes = 128 * 1024 * 1024 });
packs.Telemetry.Write(CellTelemetryKinds.Log, 3, "echo-pack loaded"u8.ToArray());
}
}
ICellPackBuilder 三面:装载点(键唯一,重复=装配错误)、回调桥(CallbackBridge.CallAsync
反向调宿主)、遥测出口(Telemetry.Write)。
ALC 管理(容器内的核心机器)
每个 pack 一个可回收程序集加载上下文,配五件纪律:
| 件 | 行为 |
|---|---|
| 隔离拓扑 | 容器自身+契约在默认上下文;pack 及其私有依赖进独立可回收上下文——pack 间同名依赖不同版本天然共存 |
| 契约单源 | 契约程序集一律解析到默认上下文——杜绝契约类型跨边界分裂 |
| 确定性解析 | pack 私有依赖按 .deps.json 装配解析;解析失败=装载错误(退出码 11+stderr 取证),无静默兜底 |
| 卸载确认 | WeakReference 存活探测+超时窗;挂起不阻塞容器——取证事件带引用线索,容器照常服务 |
| 诊断面 | 已装载清单导出、加载耗时、解析失败计数——经遥测与 stderr 可见 |
零孤儿
--parent-pid 每 1s 轮询父进程,父死即自杀(退出码 0)——容器永不遗留。宿主侧另有 kill 树
兜底:drain 超时后整树回收。
零反射与 AOT
- 装载点激活=单类型元数据查找(
assembly.GetType(startup)),无GetTypes()遍历; - 控制面线编码全部源生成;JSON 管道由使用方 context 注入;
--mode aot:NativeAOT 发布态运行——无动态装载,pack 集编译期固定(AOT 探针在 CI 全量 验证发布+真跑)。
反模式
| 症状 | 为什么错 | 正确形态 |
|---|---|---|
| 在容器进程里放 HTTP 服务器 / HttpClient / 存储客户端 | 容器是无状态计算壳——出站与状态真源归宿主 | 出站经回调桥回宿主 |
Configure 里开线程/定时器不收尾 |
drain 后线程钉住进程——收场悬挂 | 随装载点生命周期注册,drain 期间配合取消 |
| 同机混装多版本 pack 到一个容器 | pack 间隔离按上下文成立——混装语义自担 | 一容器一 spec,多版本走世代轮换 |