如何在ArgoCD清单文件中用Git SHA覆盖镜像标签？

首先纠正一个问题：你原来的ArgoCD清单里helm.image.tag的写法不符合ArgoCD的API规范，正确的参数覆盖需要用parameters数组或者values块，下面提供几种可行的方案：

方案一：CI流程中注入SHA值 #

和你之前用helm install的思路一致，在CI流程里直接替换ArgoCD应用清单的占位符，然后提交或应用该清单：

1. 修改ArgoCD应用清单的Helm配置部分：

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: my-app
  namespace: argocd
spec:
  destination:
    namespace: my-app
    server: 'https://destination-cluster'
  project: default
  syncPolicy:
    automated:
      prune: true
      selfHeal: true
  source:
    repoURL: 'https://my-git-service/repo/my-app.git'
    path: chart/my-app
    targetRevision: main
    helm:
      parameters:
        - name: image.tag
          value: <SHA_PLACEHOLDER>

2. 在CI脚本中替换占位符并应用清单：

sed -i "s/<SHA_PLACEHOLDER>/${CI_COMMIT_SHORT_SHA}/" argocd-app.yaml
kubectl apply -f argocd-app.yaml

方案二：利用ArgoCD内置变量自动获取SHA #

如果希望ArgoCD自动同步当前源码版本的短SHA作为镜像标签，可以用ArgoCD提供的内置变量$ARGOCD_APP_SOURCE_REVISION_SHORT：

1. 确保你的Helm chart支持传入image.tag参数（values.yaml可以保留默认值或留空）：

image:
  tag: "latest" # 默认值，会被ArgoCD覆盖

2. 修改ArgoCD应用清单，通过values块引用内置变量：

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: my-app
  namespace: argocd
spec:
  destination:
    namespace: my-app
    server: 'https://destination-cluster'
  project: default
  syncPolicy:
    automated:
      prune: true
      selfHeal: true
  source:
    repoURL: 'https://my-git-service/repo/my-app.git'
    path: chart/my-app
    targetRevision: main
    helm:
      values: |
        image:
          tag: "{{ $ARGOCD_APP_SOURCE_REVISION_SHORT }}"

这个变量会自动对应当前同步的源码的短SHA，无需手动注入。

方案三：用ArgoCD AppSet动态生成应用（适合多场景批量部署） #

如果需要批量部署多环境/多实例应用，可以用AppSet从Git仓库自动获取提交SHA并注入：

apiVersion: argoproj.io/v1alpha1
kind: AppSet
metadata:
  name: my-app-set
  namespace: argocd
spec:
  generators:
    - git:
        repoURL: 'https://my-git-service/repo/my-app.git'
        revision: main
        files:
          - path: "configs/*.yaml" # 根据你的配置文件路径调整
  template:
    metadata:
      name: 'my-app'
    spec:
      destination:
        namespace: my-app
        server: 'https://destination-cluster'
      project: default
      syncPolicy:
        automated:
          prune: true
          selfHeal: true
      source:
        repoURL: 'https://my-git-service/repo/my-app.git'
        path: chart/my-app
        targetRevision: '{{.revision}}'
        helm:
          parameters:
            - name: image.tag
              value: '{{.revisionShort}}'

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