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 和更高优先级的覆盖项。可以把这一过程理解为逐层覆盖:后面的高优先级来源只改动自己声明的键,其他值继续来自较低层。

Argo CD 向 Helm 传递 Values 的覆盖链路

例如 Chart 的默认 values.yaml 可以定义:

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 的核心配置如下:

yaml
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 文件与参数覆盖,快速验证关键字段:

bash
helm template shop ./charts/shop -f ./charts/shop/values-prod.yaml --set image.tag=2.4.1

预期输出中,与 Deployment 镜像相关的部分应包含:

yaml
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 为准,并从最高优先级向下反查覆盖来源,通常能最快定位配置偏差。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 Argo CD 覆盖 Helm Values

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通