如何用Kustomize在Overlay层按需修改Helm包多环境配置值？

针对你的需求，推荐以下两种高可维护性的方案，完美解决跨目录加载限制和配置重复问题：

方案一：目录重构+Kustomize HelmCharts多Values合并（推荐） #

核心思路是调整目录结构，让公共配置和环境专属配置各自存放在对应Kustomize目录下，利用Kustomize的Helm values合并能力实现分层配置，完全避开--load-restrictor的路径限制。

目录结构 #

.
├── base
│   ├── kustomization.yaml
│   └── common-values.yaml  # 所有环境通用的公共配置
└── overlays
    ├── stg
    │   ├── kustomization.yaml
    │   └── stg-values.yaml   # 测试环境专属配置
    └── prod
        ├── kustomization.yaml
        └── prod-values.yaml  # 生产环境专属配置

配置实现 #

1. Base层配置（base/kustomization.yaml）：定义Helm Chart基础信息并绑定公共配置

apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
helmCharts:
- name: [你的Chart名称]
  repo: [你的Chart仓库地址]
  version: [Chart版本号]
  releaseName: [你的Release名称]
  valuesFile: common-values.yaml  # 加载当前目录下的公共配置

2. Overlay层配置（以stg为例，overlays/stg/kustomization.yaml）：继承Base层并合并环境专属配置

apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
bases:
- ../../base
helmCharts:
- name: [你的Chart名称]
  repo: [你的Chart仓库地址]
  version: [Chart版本号]
  releaseName: [你的Release名称]
  valuesFile: stg-values.yaml
  valuesMerge: merge  # 可选值：merge（深层合并）/ override（顶层覆盖），按需选择

优势 #

• 公共配置仅在Base层维护，避免重复复制
• 环境配置仅存Overlay层，差异清晰
• 完全符合Kustomize路径限制规则，无需修改--load-restrictor参数
• 通过valuesMerge可灵活控制配置合并逻辑

构建命令 #

kustomize build overlays/stg --enable-helm

方案二：Helm Values分层加载+Kustomize ConfigMap传递（适合复杂场景） #

如果你的公共配置需要被多个Chart共享，可将公共配置封装为ConfigMap，再通过Helm的配置引用能力注入：

1. 在Base层生成公共配置ConfigMap：

# base/kustomization.yaml
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
configMapGenerator:
- name: common-config
  files:
  - common-values.yaml

2. 在Overlay层的Helm配置中引用该ConfigMap的值（需Chart支持从ConfigMap读取配置）：

# overlays/stg/kustomization.yaml
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
bases:
- ../../base
helmCharts:
- name: [你的Chart名称]
  repo: [你的Chart仓库地址]
  version: [Chart版本号]
  releaseName: [你的Release名称]
  valuesFile: stg-values.yaml
  set:
  - name: config.fromCommon
    valueFrom:
      configMapKeyRef:
        name: common-config
        key: common-values.yaml

优势 #

• 公共配置可跨Chart复用
• 配置变更无需重新渲染Helm Chart，仅需更新ConfigMap

内容的提问来源于stack exchange，提问作者mjpolak