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 目标集群和命名空间。

下面是一份可直接提交到 Git 或通过 kubectl apply 创建的 Application。示例使用公开 Git 仓库地址占位,实际操作时替换为包含目标 Chart 的仓库。
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 自身的模板错误。
helm template myapp ./deploy/myapp --namespace myapp -f ./deploy/myapp/values.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。
argocd app manifests myapp预期输出
---
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 → 渲染这一段链路;后续出现的资源差异才应进入同步和集群状态排查。