CI/CD / 系统课时

让 Argo CD 从 Git 读取 Helm Chart

让 Argo CD 从 Git 读取 Helm Chart

这一课把 Git 仓库中的 Helm Chart 接入 Argo CD,让 Application 直接以 Chart 路径和 values 作为期望状态来源,并通过本地 helm template 与 Argo CD 渲染结果交叉验证,避免把模板差异误认为集群同步问题。

学习目标

  • 配置 Application 从 Git 仓库读取 Helm Chart
  • 理解 Argo CD 使用 Helm 进行模板渲染而非管理 Helm Release
  • 用本地 Helm 与 Argo CD 命令验证渲染结果

Application 怎样读取 Chart

假设 Git 仓库中存在 deploy/myapp,目录内包含 Chart.yaml、values.yaml 和 templates/。Argo CD Application 需要同时声明 Git 仓库、目标版本、Chart 所在路径以及 Kubernetes 目标集群和命名空间。

Argo CD从Git读取Helm Chart的数据流

下面是一份可直接提交到 Git 或通过 kubectl apply 创建的 Application。示例使用公开 Git 仓库地址占位,实际操作时替换为包含目标 Chart 的仓库。

yaml
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: myapp
  namespace: argocd
spec:
  project: default
  source:
    repoURL: https://github.com/example/platform-config.git
    targetRevision: main
    path: deploy/myapp
    helm:
      valueFiles:
        - values.yaml
  destination:
    server: https://kubernetes.default.svc
    namespace: myapp
  syncPolicy:
    syncOptions:
      - CreateNamespace=true

这是配置文件而不是独立程序。repoURL 指向 Git 仓库,targetRevision 可以是分支、标签或提交,path 必须指向仓库内 Chart 根目录。valueFiles 的路径相对于 Chart 根目录解析。

Helm 在这里负责什么

Argo CD 读取 Chart 后会使用 Helm 的模板能力生成 Kubernetes manifests,再由 Argo CD 比较期望状态与集群实际状态并执行同步。因此,Helm 在这里主要充当模板渲染器,应用的持续同步生命周期由 Argo CD 管理。

这一区别会直接影响排障思路:模板渲染失败,应检查 Chart、values 和 Helm 模板;渲染成功但资源 OutOfSync,则继续检查 Git 期望状态与集群实际状态的差异。

先在本地验证渲染

在提交 Application 前,可以从仓库根目录运行 Helm。这样能先排除 Chart 自身的模板错误。

bash
helm template myapp ./deploy/myapp --namespace myapp -f ./deploy/myapp/values.yaml

预期输出

yaml
---
# Source: myapp/templates/deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: myapp

实际资源数量和字段由 Chart 决定,因此输出可能更长;关键是命令成功生成合法 manifests,而不是得到完全相同的示例文本。

如果这里已经出现 template、YAML 解析或缺少 values 等错误,应先修复 Chart,再让 Argo CD 读取它。这样可以把 Git/Helm 问题与 Argo CD 同步问题分开。

验证 Argo CD 看到的 manifests

Application 创建并完成仓库读取后,可以直接查看 Argo CD 为它生成的 manifests。

bash
argocd app manifests myapp

预期输出

yaml
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: myapp

资源顺序和具体字段可能随 Chart 与工具版本不同。验证时应关注关键对象、镜像、环境变量、副本数等业务字段是否与本地 helm template 的结果一致,而不是机械比较注释或输出顺序。

如果本地和 Argo CD 的关键字段不同,优先核对 targetRevision、path、valueFiles 以及是否配置了额外 Helm 参数。只有两边使用同一 Git 版本和同一组 values,渲染结果才具有可比性。

从 Git 到集群的边界

把 Chart 放进 Git 后,Git 中的 Chart、values 和 Application 配置共同构成可审查的期望状态来源。修改镜像标签或副本数时,应优先修改 Git 并提交,再让 Argo CD 检测差异和同步,而不是先手工修改集群再设法补回配置。

当本地 Helm 能正常渲染、Argo CD 能读取相同 revision,并且 argocd app manifests 中的关键资源与本地结果一致时,就已经验证了 Git → Chart → 渲染这一段链路;后续出现的资源差异才应进入同步和集群状态排查。

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

目录与阅读设置

阅读设置

17

记录一个想法

让 Argo CD 从 Git 读取 Helm Chart

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

登录哪都通