CI/CD / 系统课时
用 Argo CD 覆盖 Helm Values
用 Argo CD 覆盖 Helm Values
Argo CD 使用 Helm 时,本质上会根据 Application 中声明的配置渲染 Chart,再把结果与集群期望状态同步。本篇通过一个 Application 配置说明 Values 文件、内联 Values 和 parameters 如何共同影响最终值,并重点处理容易出错的覆盖优先级。
学习目标
- 配置 Argo CD 的
valueFiles、valuesObject与parameters - 理解多种 Helm Values 来源叠加时的覆盖关系
- 使用 Argo CD 和 Helm 的渲染结果验证最终配置
Values 从多个来源进入渲染过程
Chart 自带的 values.yaml 提供默认值,Application 可以继续指定环境 Values 和更高优先级的覆盖项。可以把这一过程理解为逐层覆盖:后面的高优先级来源只改动自己声明的键,其他值继续来自较低层。

例如 Chart 的默认 values.yaml 可以定义:
replicaCount: 1
image:
repository: registry.example.com/shop
tag: latest生产环境文件 values-prod.yaml 再把副本数改为 3,而 Application 可以继续通过更高优先级的参数覆盖镜像标签。
在 Application 中声明覆盖
下面的片段示例依赖一个已经存在于 Git 仓库 charts/shop 路径下的 Helm Chart,并假设其中存在 values-prod.yaml。Application 的核心配置如下:
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
name: shop-prod
namespace: argocd
spec:
project: default
source:
repoURL: https://git.example.com/platform/shop-deploy.git
targetRevision: main
path: charts/shop
helm:
valueFiles:
- values-prod.yaml
valuesObject:
service:
type: ClusterIP
parameters:
- name: image.tag
value: "2.4.1"
destination:
server: https://kubernetes.default.svc
namespace: shop-prod
syncPolicy:
automated:
prune: true
selfHeal: true这是配置文件而不是独立执行程序。生效后,Argo CD 使用 values-prod.yaml 覆盖 Chart 默认值,valuesObject 提供结构化的内联覆盖,而 parameters 中的 image.tag=2.4.1 具有更高优先级。验证时应检查 Argo CD 生成的 manifests,而不是只阅读某一份 Values 文件。
记住真正有用的优先级
在 Argo CD 的 Helm 配置中,可以按从低到高记住:Chart 的 values.yaml、valueFiles、values、valuesObject、parameters。同一层也可能继续发生覆盖,例如配置多个 valueFiles 时,后列出的文件可以覆盖前面文件中的同名值。
因此,如果 values-prod.yaml 写着 image.tag: 2.4.0,而 parameters 又设置 image.tag=2.4.1,最终渲染使用的是 2.4.1。排查“明明改了 Values 却没生效”时,应先寻找更高优先级来源是否再次覆盖了同一个键。
验证最终传入的值
如果本地拥有同一份 Chart,可以用 Helm 模拟 Values 文件与参数覆盖,快速验证关键字段:
helm template shop ./charts/shop -f ./charts/shop/values-prod.yaml --set image.tag=2.4.1预期输出中,与 Deployment 镜像相关的部分应包含:
containers:
- name: shop
image: "registry.example.com/shop:2.4.1"这里假设 Chart 使用 image.repository 与 image.tag 拼接镜像地址;实际资源名称和其他字段取决于模板。若本地渲染正确而 Argo CD 结果不同,应继续核对 Application 的 targetRevision、path、valueFiles 和其他覆盖来源。
让覆盖来源保持可追踪
生产配置最好把长期存在的环境差异保存在 Git 中的 Values 文件或 valuesObject,把 parameters 留给少量明确覆盖。这样查看一次 Application 变更时,可以直接回答“默认值来自哪里、环境改了什么、最高优先级又覆盖了什么”。
当同一个键可能出现在多个来源时,不要依赖记忆判断最终值。以 Argo CD 实际生成的 manifests 为准,并从最高优先级向下反查覆盖来源,通常能最快定位配置偏差。