使用Helm构建Kustomize失败问题排查

核心错误原因 #

1. Namespace资源缺失必填名称
   错误信息明确指出missing metadata.name in object {{v1 Namespace} {{ } map[name:] map[]}}，说明你的project-namespace.yml文件里的Namespace对象未定义metadata.name字段——这是Kubernetes命名空间资源的必填项，必须补充，示例如下：

   apiVersion: v1
   kind: Namespace
   metadata:
     name: monitoring  # 替换为你实际需要的命名空间名称
   

2. Kustomize与Helm目录结构混用错误
   你将Kustomize的kustomization.yml放在Helm Chart的templates目录下，这是完全错误的结构：

   • Helm的templates目录用于存放Helm模板语法文件，是Helm渲染时的专属目录
   • Kustomize需独立于Helm Chart结构，或通过Kustomize的helmChartInflationGenerator功能引用完整Helm Chart，而非直接读取Helm模板文件

3. Shell命令语法错误
   你执行的命令中使用->重定向输出属于语法错误，正确的shell重定向应使用>；同时kubectl kustomize本身已包含build功能，无需额外添加build参数：

   kubectl kustomize . --enable-helm > dummy.yml
   

正确使用方案（二选一） #

方案一：用Kustomize直接管理原生K8s资源（弃用Helm模板） #

若templates目录下的YAML均为原生Kubernetes资源（无Helm模板变量），可完全脱离Helm，调整目录结构如下：

project
  - k8s
    - base
      - project-namespace.yml
      - grafana
        - grafana-service.yml
        - grafana-deployment.yml
        - ...
      - prometheus
        - prometheus-service.yml
        - prometheus-deployment.yml
        - ...
      - kustomization.yml
    - prod
      - kustomization.yml
    - test
      - kustomization.yml

之后在base/kustomization.yml中引用资源，执行构建命令：

kubectl kustomize ./k8s/base > dummy.yml

方案二：用Kustomize集成Helm Chart（复用values.yml） #

若需保留Helm的values.yml渲染模板，需通过Kustomize的helmCharts字段引用完整Helm Chart，调整结构如下：

project
  - helm-k8s
    - values.yml
    - Chart.yml
    - templates
      - ...  # 保留原Helm模板文件
  - kustomize
    - base
      - kustomization.yml
    - prod
      - kustomization.yml
    - test
      - kustomization.yml

修改kustomize/base/kustomization.yml，添加Helm Chart引用：

apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
metadata:
  name: open-electrons-monitoring-kustomization

helmCharts:
- name: monitoring  # 对应Helm Chart.yml中的name字段
  repo: file://../../helm-k8s  # 本地Chart的相对路径
  valuesFile: ../../helm-k8s/values.yml
  releaseName: monitoring
  namespace: monitoring  # 部署目标命名空间

执行构建命令：

kubectl kustomize ./kustomize/base --enable-helm > dummy.yml

此时Kustomize会调用Helm渲染Chart，生成的资源可被Kustomize进一步处理。

误区澄清 #

Kustomize完全支持使用Helm的values.yml，但必须通过helmCharts字段的正确集成方式，而非混用Helm模板目录与Kustomize结构。你之前的问题本质是资源定义缺失必填项+目录结构误用。

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