kwok

KWOK 模拟 Kubernetes 集群

补充说明

KWOK（Kubernetes WithOut Kubelet）用模拟节点和 Pod 快速搭建轻量 Kubernetes 集群，不需要真实容器运行时。它适合测试调度器、控制器、Operator 和大规模集群行为，能秒级创建成百上千个节点。

核心资源：Cluster、Node、Pod、Stage 和 Metric。KWOK 控制器维护模拟对象状态，可以和真实 API Server 配合使用。

语法

安装 CLI：

go install sigs.k8s.io/kwok/cmd/kwok@latest
go install sigs.k8s.io/kwok/cmd/kwokctl@latest
kwokctl create cluster --name demo
kubectl get nodes

在已有集群安装 KWOK 控制器：

kubectl apply -f https://github.com/kubernetes-sigs/kwok/releases/latest/download/kwok.yaml
kubectl -n kube-system get pods -l app=kwok-controller

创建模拟节点：

kubectl apply -f - <<'EOF'
apiVersion: v1
kind: Node
metadata:
  name: fake-node-1
  annotations:
    kwok.x-k8s.io/node: fake
  labels:
    kubernetes.io/hostname: fake-node-1
    kubernetes.io/arch: amd64
    kubernetes.io/os: linux
status:
  allocatable:
    cpu: "32"
    memory: 128Gi
    pods: "110"
  capacity:
    cpu: "32"
    memory: 128Gi
    pods: "110"
  conditions:
  - type: Ready
    status: "True"
EOF
kubectl get nodes

创建 Pod 观察模拟调度：

kubectl run demo --image=nginx --overrides='{"spec":{"nodeName":"fake-node-1"}}'
kubectl get pods -o wide

使用 Stage 控制 Pod 状态：

kubectl apply -f - <<'EOF'
apiVersion: kwok.x-k8s.io/v1alpha1
kind: Stage
metadata:
  name: pod-running
spec:
  resourceRef:
    apiGroup: v1
    kind: Pod
  selector:
    matchLabels:
      app: demo
  delay:
    durationMilliseconds: 500
  next:
    statusTemplate: |
      phase: Running
EOF

注意

• KWOK 节点上的 Pod 不会真正运行容器，不能用于验证应用逻辑。
• 模拟节点需要正确的 status.allocatable 和 conditions，否则调度器不会调度。
• 与真实节点混用时，用 label/taint 隔离测试负载。
• KWOK 控制器的 Stage 规则可能影响真实 Pod，先在独立集群验证。
• 大规模模拟节点会占用 API Server 和 etcd 资源。
• 删除模拟节点前先清理其上的 Pod，避免卡在 Terminating。
• 版本要与 Kubernetes API 版本匹配，CRD 变更可能导致旧配置失效。
• 不要在生产集群随意安装 KWOK 控制器。

相关命令

• kwokctl create cluster — 创建模拟集群
• kwokctl delete cluster — 删除模拟集群
• kubectl get nodes — 查看模拟节点
• kubectl get pods -o wide — 查看调度结果
• kubectl get stages — 查看状态规则

参考链接

• https://kwok.sigs.k8s.io/
• https://github.com/kubernetes-sigs/kwok
• https://kwok.sigs.k8s.io/docs/user/kwok-manage-nodes/