4. Overlay 模式概念：Base 与 Overlay 的关系、环境差异化设计思想

在 Kustomize 的配置管理体系中，Overlay 模式是核心设计范式。它通过将通用配置与特定环境差异分离，实现了“一次定义，多处复用”的声明式管理。理解 Base 与 Overlay 的关系，是掌握环境差异化配置的基础。

4.1 Base：通用配置的“基线”

Base 是 Kustomize 项目的根目录，包含所有环境共享的 Kubernetes 资源定义。它通常包含一个 kustomization.yaml 文件，以及若干 YAML 资源文件（如 Deployment、Service、ConfigMap 等）。Base 的设计原则是：与环境无关，只描述应用本身的逻辑结构。

4.2 Overlay：环境差异的“叠加层”

Overlay 是建立在 Base 之上的差异化配置层。每个 Overlay 代表一个特定的部署环境（如 dev、staging、production）。Overlay 通过 patches、images、namePrefix、namespace 等字段，对 Base 中的资源进行局部修改，而无需复制整个资源文件。

4.3 Base 与 Overlay 的关系模型

Base 与 Overlay 之间是“继承-叠加”关系。Overlay 通过 resources 字段引用 Base，然后使用 patchesStrategicMerge 或 patchesJson6902 对 Base 中的资源进行修改。Kustomize 在构建时，会先将 Base 中的所有资源加载到内存，然后按顺序应用 Overlay 中的补丁，最终生成完整的、环境特定的 YAML 输出。

4.4 环境差异化设计思想

Overlay 模式的核心设计思想是“最小差异原则”：只修改那些真正因环境而异的配置项，保持 Base 的纯净。这种设计带来了以下优势：

• 减少重复：避免为每个环境复制相同的资源定义。
• 提升一致性：所有环境共享同一个 Base，确保基础配置的统一。
• 简化审计：环境差异集中在 Overlay 中，便于审查和追踪。
• 降低错误：修改 Base 时，所有环境自动同步更新，减少遗漏。

4.5 典型目录结构示例

以下是一个标准的 Kustomize 项目结构，展示了 Base 与 Overlay 的组织方式：

my-app/
├── base/
│   ├── kustomization.yaml
│   ├── deployment.yaml
│   ├── service.yaml
│   └── configmap.yaml
└── overlays/
    ├── dev/
    │   ├── kustomization.yaml
    │   ├── patch-replicas.yaml
    │   └── patch-image.yaml
    ├── staging/
    │   ├── kustomization.yaml
    │   └── patch-image.yaml
    └── prod/
        ├── kustomization.yaml
        ├── patch-replicas.yaml
        └── patch-resources.yaml

在这个结构中，base/ 定义了应用的通用资源，而每个 overlays/ 下的子目录只包含与环境相关的差异补丁。这种结构清晰地将“通用”与“特定”分离，是环境差异化配置的最佳实践。

4.6 环境差异化设计思想总结

Overlay 模式的设计思想可以概括为：以 Base 为锚点，以 Overlay 为变量。通过这种分层抽象，Kustomize 使得 Kubernetes 配置管理从“复制-粘贴”模式进化为“继承-叠加”模式，大幅提升了多环境部署的可维护性和可靠性。