FluxCD中Helm Release镜像未自动更新问题咨询

根本原因 #

你当前的配置存在链路断层：Flux Kustomization的spec.images镜像替换规则，默认仅对其直接管理的原生Kubernetes工作负载（Deployment、StatefulSet等）的镜像字段生效，无法自动修改HelmRelease资源spec.values下的镜像配置。你当前让Image Automation更新fluxkustomize.yaml里的镜像标签，完全作用不到HelmRelease的values配置，这是故障的核心原因。

修复方案 #

方案1（推荐）：直接让Image Automation更新HelmRelease配置 #

直接删掉冗余的fluxkustomize.yaml文件，调整配置如下：

1. 修改../application/stat/helmrelease.yaml，在镜像标签字段添加Image Policy占位注释：

# ../application/stat/helmrelease.yaml
---
apiVersion: helm.toolkit.fluxcd.io/v2beta1
kind: HelmRelease
metadata:
  name: stat
spec:
  values:
    api:
      image:
        repository: ecr/tor
    image:
      tag: 1.3.0 # {"$imagepolicy": "tor:stat:tag"} # 新增占位注释
  interval: 1m0s
  releaseName: stat
  chart:
    spec:
      chart: ./helm/stat
      interval: 1m0s
      valuesFile: ./helm/stat/values.yaml
      sourceRef:
        kind: GitRepository
        name: stat
        namespace: tor

2. 调整你的ImageUpdateAutomation配置，将更新路径指向HelmRelease所在的目录即可，后续新镜像推送后，自动化工具会直接更新Git中HelmRelease的tag字段，根Kustomization同步后会自动触发HelmRelease发布。

方案2（保留现有fluxkustomize.yaml的前提下修复） #

如果你要保留现有双层Kustomization结构，需要把fluxkustomize.yaml的镜像替换改为补丁规则，直接修改HelmRelease的values字段：

# fluxkustomize.yaml
---
apiVersion: kustomize.toolkit.fluxcd.io/v1beta1
kind: Kustomization
metadata:
  name: stat
  namespace: tor
spec:
  interval: 1m0s
  prune: false
  sourceRef:
    kind: GitRepository
    name: gitops
    namespace: tor
  # 替换原images字段，用补丁修改HelmRelease的values配置
  patches:
    - patch: |-
        - op: replace
          path: /spec/values/image/tag
          value: 1.3.4 # {"$imagepolicy": "tor:stat:tag"}
      target:
        kind: HelmRelease
        name: stat

同步状态校验 #

配置修改后执行以下命令排查各组件状态：

• 校验镜像策略是否正常：flux get image policy -n tor
• 校验镜像自动化是否正常提交Git变更：flux get image update -n tor
• 校验Kustomization是否正常同步Git配置到集群：flux get kustomization -n tor
• 校验HelmRelease是否正常发布：flux get helmrelease -n tor

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