ArgoCD未安装Helm Chart依赖问题求助

问题描述 #

通过helm install命令可正常安装带依赖的Helm Chart，但ArgoCD同步完成后完全忽略依赖配置，依赖Chart的资源未生成。已知前提：

• 采用标准Helm 3 Chart，存储于无需认证的私有仓库，无依赖的Chart可正常从该仓库安装；
• 主Chart（app-chart）和依赖Chart（base-chart）均包含Helm pre-install钩子，且需保留钩子权重，ArgoCD文档明确支持该特性。

相关配置文件 #

基础依赖Chart的Chart.yaml #

apiVersion: "v2"
name: "base-chart"
version: "1.0.0"
appVersion: "1.0.0"

主Chart的Chart.yaml #

apiVersion: "v2"
name: "app-chart"
version: "1.0.1"
appVersion: "1.0.1"
dependencies:
- name: "base-chart"
  version: "1.0.0"
  repository: "https://<my-private-repo>/repository/<repo>"
  alias: "base"

ArgoCD应用清单 #

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: myapp
  namespace: argocd
  labels:
    name: myapp
  annotations:
    argocd.argoproj.io/sync-wave: "1"
spec:
  project: default

  sources:
    - repoURL: https://<mynexus.com>/repository/<repo>/
      targetRevision: 1.0.1
      chart: app-chart

  destination:
    server: https://kubernetes.default.svc
    namespace: myapp

ArgoCD版本信息 #

[root@kubernetes1 mydir]# argocd version
argocd: v2.12.1+26b2039
  BuildDate: 2024-08-16T17:01:06Z
  GitCommit: 26b2039a55b9bdf807a70d344af8ade5171d3d39
  GitTreeState: clean
  GoVersion: go1.22.6
  Compiler: gc
  Platform: linux/amd64
argocd-server: v2.12.1+26b2039
  BuildDate: 2024-08-16T16:42:13Z
  GitCommit: 26b2039a55b9bdf807a70d344af8ade5171d3d39
  GitTreeState: clean
  GoVersion: go1.22.4
  Compiler: gc
  Platform: linux/amd64
  Kustomize Version: v5.4.2 2024-05-22T15:19:38Z
  Helm Version: v3.15.2+g1a500d5
  Kubectl Version: v0.29.6
  Jsonnet Version: v0.20.0

排查与解决步骤 #

1. 开启ArgoCD的Helm依赖更新开关 #

ArgoCD默认不会自动拉取Helm依赖，需显式配置helm.dependencyUpdate参数。修改应用清单的sources部分：

sources:
  - repoURL: https://<mynexus.com>/repository/<repo>/
    targetRevision: 1.0.1
    chart: app-chart
    helm:
      parameters:
        - name: "helm.dependencyUpdate"
          value: "true"

也可在ArgoCD UI中编辑应用，找到Helm配置项，勾选「Update dependencies before install」选项。

2. 验证依赖仓库的可访问性 #

进入ArgoCD repo server容器，手动测试依赖仓库的拉取：

# 进入repo server pod
kubectl exec -n argocd -it <argocd-repo-server-pod-name> -- bash
# 添加依赖仓库并拉取base-chart
helm repo add test-repo https://<my-private-repo>/repository/<repo>
helm pull test-repo/base-chart --version 1.0.0

若拉取失败，检查网络策略、防火墙规则或仓库地址是否正确。

3. 检查Chart依赖定义的规范性 #

确认主Chart的Chart.yaml依赖配置：

• repository地址与实际仓库完全一致，注意末尾斜杠是否多余；
• version范围准确（此处使用固定版本1.0.0无问题）；
• alias无命名冲突。

4. 查看ArgoCD详细同步日志 #

通过命令行或UI查看应用同步的详细日志，寻找依赖拉取相关信息：

argocd app logs myapp --sync

UI中可进入应用详情页，查看「Events」和「Logs」标签。

5. 本地模拟ArgoCD的Helm流程 #

在本地执行依赖更新并渲染Chart，验证是否能生成依赖资源：

# 更新依赖
helm dependency update ./app-chart
# 用ArgoCD使用的Helm版本渲染
helm template ./app-chart --namespace myapp

若渲染能生成依赖资源，说明问题出在ArgoCD配置；若渲染也无依赖资源，需检查Chart本身的依赖配置。

6. 检查ArgoCD项目的仓库权限 #

确认ArgoCD的default项目允许访问依赖仓库：进入ArgoCD UI的「Projects」→「default」→「Repositories」，检查是否包含依赖仓库URL，或临时设置为「Allow all repositories」（生产环境不建议）。

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