Kustomize 架构与设计思路分析

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

一句话定位

Kustomize 用 overlay/patch/transformer 管理 Kubernetes YAML 差异，是 kubectl 原生支持的配置定制工具链。

核心架构图

┌────────────────────────────────────────────────────────────────────────────┐
│ Base manifests and overlays                                                │
│ Teams maintain reusable YAML plus environment-specific customization.      │
└────────────────────────────────────────────────────────────────────────────┘
                                       │
                                       ▼
┌────────────────────────────────────────────────────────────────────────────┐
│ Kustomize engine                                                           │
│ Resources, generators, patches, transformers, labels, namespaces, and      │
│ image changes.                                                             │
└────────────────────────────────────────────────────────────────────────────┘
                                       │
                                       ▼
┌────────────────────────────────────────────────────────────────────────────┐
│ Rendered output                                                            │
│ Produces final Kubernetes manifests without requiring templates at apply   │
│ time.                                                                      │
└────────────────────────────────────────────────────────────────────────────┘
                                       │
                                       ▼
┌────────────────────────────────────────────────────────────────────────────┐
│ Consumers                                                                  │
│ kubectl, GitOps controllers, CI pipelines, and platform release workflows. │
└────────────────────────────────────────────────────────────────────────────┘

模块分层

关键数据流

base 定义通用资源
        │
        ▼
overlay 引入 base
        │
        ▼
transformers/patches 应用环境差异
        │
        ▼
生成最终 YAML
        │
        ▼
kubectl/Argo CD 应用

设计决策与哲学

• 补齐 配置管理 维度：Kustomize 让当前 wiki 不只停留在 serving engine 或单个 operator，而能解释 Kubernetes 平台里的相邻控制面。
• 边界判断：Helm 是模板和 package；Kustomize 是 YAML transformer，适合 GitOps 中的环境 overlay。
• 选型价值：它应和 gitops, kubernetes 一起看，而不是孤立评估。