KWOK 架构与设计思路分析

原文：raw/kwok-architecture-analysis.md · 仓库：https://github.com/kubernetes-sigs/kwok · 优先级 P1

一句话定位

KWOK 是 Kubernetes WithOut Kubelet，用 fake nodes/pods 模拟大规模集群，适合调度、控制器和 scalability 测试。

核心架构图

┌────────────────────────────────────────────────────────────────────────────┐
│ Large-cluster simulation need                                              │
│ Tests need many nodes or workloads without running kubelets.               │
└────────────────────────────────────────────────────────────────────────────┘
                                       │
                                       ▼
┌────────────────────────────────────────────────────────────────────────────┐
│ KWOK controller                                                            │
│ Watches fake nodes and pods and drives lifecycle/status transitions.       │
└────────────────────────────────────────────────────────────────────────────┘
                                       │
                                       ▼
┌────────────────────────────────────────────────────────────────────────────┐
│ Stage configuration                                                        │
│ Rules define how objects move through simulated phases and conditions.     │
└────────────────────────────────────────────────────────────────────────────┘
                                       │
                                       ▼
┌────────────────────────────────────────────────────────────────────────────┐
│ Output                                                                     │
│ Kubernetes API server sees scalable simulated nodes, pods, and status for  │
│ control-plane tests.                                                       │
└────────────────────────────────────────────────────────────────────────────┘

模块分层

关键数据流

创建 KWOK cluster 或接入现有 apiserver
        │
        ▼
声明大量 fake nodes/pods
        │
        ▼
kwok controller 模拟状态变化
        │
        ▼
被测 scheduler/controller 观察大规模对象
        │
        ▼
收集性能和行为结果

设计决策与哲学

• 补齐 大规模集群模拟 维度：KWOK 让当前 wiki 不只停留在 serving engine 或单个 operator，而能解释 Kubernetes 平台里的相邻控制面。
• 边界判断：kind 提供真实小集群；KWOK 提供便宜的大规模对象模拟。
• 选型价值：它应和 kubernetes, model-serving-operator 一起看，而不是孤立评估。