Kubebuilder
Kubebuilder 是构建 Kubernetes APIs using CRDs 的 SDK，把 API type、marker、controller-runtime manager、webhook、RBAC 和 manifests 生成流程标准化。 详见 src-kubebuilder-architecture。
证据说明：本次官方默认分支快照为 5f31d1f3c075，该 commit 不代表 release。src-kubebuilder-architecture 保留 2026-06-14 的 raw-backed Source 快照；当前跨项目证据与职责图见 k8s-core-controller-map。
在 M5-A Controller 地图中的位置
Kubebuilder 负责作者工作流、脚手架与项目布局，通过生成的工程组织 controller-runtime 组件，并调用 controller-tools 生成 CRD、RBAC 等资产。运行时 reconcile 语义由 controller-runtime 与项目自己的业务逻辑承担；Kubebuilder 不负责执行控制循环。三者的构建期与运行期边界见 k8s-core-controller-map。
架构边界
kubebuilder 解决项目结构和生成路径；controller-runtime 解决运行时 controller 抽象。
什么时候用
| 场景 | 判断 |
|---|---|
需要 CRD / controller 脚手架 能力 |
适合，Kubebuilder 正是这一层的代表项目。 |
| 需要和 Kubernetes API / controller / runtime 集成 | 适合，它的主要价值来自 Kubernetes-native 工作流。 |
| 需要替代相邻层全部职责 | 不适合，应和 kubernetes, model-serving-operator, declarative-agent-management 组合。 |
核心组件
- CLI scaffolding: init/create api/webhook
- API markers: kubebuilder validation/printcolumn/rbac
- Project layout: api/ controllers/ config/
- Generation: CRD/RBAC/webhook/deepcopy manifests
选型提示
把 Kubebuilder 放在 CRD / controller 脚手架 维度评估：先看它输入什么对象、输出什么对象，再看它是否会进入请求路径、调度路径、节点路径或 CI/实验路径。这个边界比 star 数更能决定它是否适合当前平台。