Table of Contents

容器内部

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,多版本走世代轮换

想深入