Argocd-image-updater更新Application镜像但Deployment镜像未同步求助

核心原因 #

ArgoCD Image Updater仅更新Application的spec.kustomize.images字段，但Kustomize无法将该变更同步到Deployment，通常是因为Deployment镜像字段与Kustomize镜像替换规则不匹配，或者Kustomize配置未正确关联镜像替换逻辑。

正确的Kustomize配置示例 #

1. kustomization.yaml（核心配置） #

apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
# 关联Deployment资源文件
resources:
  - deployment.yaml
# 定义镜像替换规则，ArgoCD Image Updater会动态修改此处对应字段（通过Application的spec.kustomize.images覆盖）
images:
  - name: cblairupliv/doc-storage-ui
    newName: cblairupliv/doc-storage-ui
    newTag: 0.1.0  # 初始标签，将被Image Updater自动更新

2. deployment.yaml（需与Kustomize规则匹配） #

Deployment中的镜像名称必须与kustomization.yaml里的images.name完全一致（包含完整仓库地址）：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: doc-storage-ui
spec:
  replicas: 1
  selector:
    matchLabels:
      app: doc-storage-ui
  template:
    metadata:
      labels:
        app: doc-storage-ui
    spec:
      containers:
        - name: doc-storage-ui
          # 镜像名需与kustomization.yaml的images.name完全匹配
          image: cblairupliv/doc-storage-ui:0.1.0
          ports:
            - containerPort: 80

问题排查与解决步骤 #

1. 镜像名称匹配检查
   确保Deployment中的镜像字段（包括完整仓库地址）与kustomization.yaml里的images.name完全一致。例如：

   • 错误写法：image: doc-storage-ui:0.1.0（缺少仓库前缀）
   • 正确写法：image: cblairupliv/doc-storage-ui:0.1.0（与Kustomize规则完全匹配）

2. ArgoCD Application配置验证
   确认Application的spec.source.kustomize.images已被Image Updater正确更新，且同步策略设置正确：

   • 开启自动同步或手动同步时勾选Prune和Sync选项
   • 检查Application注解是否正确配置（确保写入方式为ArgoCD）：

     annotations:
       argocd-image-updater.argoproj.io/image-list: doc-storage-ui=cblairupliv/doc-storage-ui:~0.1
       argocd-image-updater.argoproj.io/doc-storage-ui.update-strategy: semver
       argocd-image-updater.argoproj.io/write-back-method: argocd
     

3. Kustomize构建日志排查
   在ArgoCD控制台查看应用的同步日志，检查是否存在Kustomize构建错误（例如镜像匹配失败、资源冲突等）。

4. Overlay场景特殊处理
   如果使用Kustomize Overlay结构，确保Base层的镜像规则未被Overlay层覆盖，且Overlay的images规则允许ArgoCD的动态修改生效。

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