ArgoCD引用GitLab外部Helm Values文件部署问题求助

核心问题分析 #

你当前的配置存在两个关键问题：

• 误用GitLab网页预览链接：你填写的https://gitlab.com/.../-/blob/master/deployment/valtues.yaml是GitLab的页面展示链接，并非可直接下载的原始文件地址，ArgoCD无法通过这类链接获取values配置内容。
• 文件名拼写错误：配置里的valtues.yaml应为values.yaml，拼写错误会导致文件无法被识别。

解决方案 #

1. 获取GitLab原始文件的正确URL #

在GitLab的values.yaml文件页面，点击右上角的**「Raw」按钮**，复制弹出的原始文件地址，格式示例：
https://gitlab.com/maxdev42-gitops-projects/reactdockerapp2/-/raw/master/deployment/values.yaml

2. 修改Application资源配置 #

替换helm.valueFiles中的链接为原始文件URL，并修正文件名拼写：

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: react-docker-app
  namespace: argocd
spec:
  syncPolicy:
    automated:
      selfHeal: true
  project: default
  destination:
    server: https://kubernetes.default.svc
    namespace: argocd
  source:
    repoURL: https://gitlab.com/api/v4/projects/40489526/packages/helm/stable
    targetRevision: 0.8.0
    chart: react-chart
    helm:
      valueFiles:
      - https://gitlab.com/maxdev42-gitops-projects/reactdockerapp2/-/raw/master/deployment/values.yaml

3. 私有仓库权限处理（若目标仓库为私有） #

如果存放values.yaml的GitLab仓库是私有，需要给ArgoCD配置访问权限：

• 在GitLab创建个人访问令牌（PAT），勾选read_repository权限。
• 在ArgoCD所在命名空间创建存储令牌的Secret：

  kubectl create secret generic gitlab-values-repo-secret \
    --namespace argocd \
    --from-literal=url=https://gitlab.com/maxdev42-gitops-projects/reactdockerapp2.git \
    --from-literal=username=<你的GitLab用户名> \
    --from-literal=password=<你的PAT令牌>
  

• 修改Application的source部分，关联这个Secret：

  source:
    repoURL: https://gitlab.com/api/v4/projects/40489526/packages/helm/stable
    targetRevision: 0.8.0
    chart: react-chart
    helm:
      valueFiles:
      - https://gitlab.com/maxdev42-gitops-projects/reactdockerapp2/-/raw/master/deployment/values.yaml
    secretRef:
      name: gitlab-values-repo-secret
  

4. 切换到ApplicationSet的适配方案 #

后续迁移到ApplicationSet时，可通过两种方式引用跨仓库values.yaml：

• 直接使用原始文件URL：在模板的helm.valueFiles中填入正确的原始文件地址，权限配置方式与上述一致。
• 通过Git生成器引入：将values.yaml所在仓库作为Git源，在ApplicationSet中直接引用文件内容，示例：

  apiVersion: argoproj.io/v1alpha1
  kind: ApplicationSet
  metadata:
    name: react-docker-app-set
    namespace: argocd
  spec:
    generators:
    - git:
        repoURL: https://gitlab.com/maxdev42-gitops-projects/reactdockerapp2.git
        revision: master
        files:
        - path: deployment/values.yaml
    template:
      metadata:
        name: react-docker-app-{{name}}
      spec:
        syncPolicy:
          automated:
            selfHeal: true
        project: default
        destination:
          server: https://kubernetes.default.svc
          namespace: argocd
        source:
          repoURL: https://gitlab.com/api/v4/projects/40489526/packages/helm/stable
          targetRevision: 0.8.0
          chart: react-chart
          helm:
            valueFiles:
            - $values/deployment/values.yaml
  

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