如何在AKS环境通过FLUX安装本地Helm Chart？

错误根源 #

你遇到的错误：

failed to decode Kubernetes YAML from /tmp/kustomization-3631900086/2-helm/Chart.yaml: missing kind in object {{v2 } {{ } map[] map[]}}

本质是Flux的Kustomization资源仅能处理Kubernetes原生清单或Kustomize配置，而Helm的Chart.yaml是Helm专属格式，不属于标准Kubernetes资源（缺少Kubernetes要求的apiVersion和kind字段），直接让Kustomization指向Helm Chart目录会导致解析失败。

正确部署方案：用Flux专属Helm资源管理本地Chart #

Flux提供了HelmRepository和HelmRelease资源专门处理Helm Chart部署，针对Git仓库中的本地Chart，按以下步骤操作：

1. 定义HelmRepository资源 #

创建资源指向你的Git仓库，让Flux能拉取本地Chart：

apiVersion: source.toolkit.fluxcd.io/v1
kind: HelmRepository
metadata:
  name: local-app-charts
  namespace: flux-system
spec:
  type: git
  url: https://github.com/rhod3rz/temp
  ref:
    branch: main
  interval: 1m0s

2. 定义HelmRelease资源 #

创建资源指定要部署的本地Chart及配置：

apiVersion: helm.toolkit.fluxcd.io/v2beta1
kind: HelmRelease
metadata:
  name: app1-release
  namespace: default
spec:
  interval: 5m
  chart:
    spec:
      chart: ./2-helm
      version: "0.1.0"
      sourceRef:
        kind: HelmRepository
        name: local-app-charts
        namespace: flux-system
      interval: 1m
  values:
    # 可在此覆盖Chart中values.yaml的配置，例如：
    # replicaCount: 2

3. 用Kustomization管理Flux资源 #

将上述两个资源放在Git仓库的独立目录（如flux-config），并创建kustomization.yaml：

apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
  - helm-repo.yaml
  - helm-release.yaml

4. 配置Flux指向该目录 #

在AKS门户的Flux插件中，创建新的Kustomization，指向仓库中的flux-config目录，而非直接指向2-helm。

额外检查项 #

• 确保Chart.yaml格式符合Helm 3标准：

apiVersion: v2
name: parent-chart
description: Parent chart for app1
version: 0.1.0
appVersion: "1.0.0"
dependencies:
  - name: app1
    version: 0.1.0
    repository: file://./charts/app1

• 确认子Chart的相对路径配置正确，Flux拉取仓库后能正常识别子Chart位置。

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