如何通过Helm Chart/YAML配置ArgoCD在部署前用Dockerfile处理镜像？

我目前在ArgoCD中加载应用时，从镜像仓库拉取镜像的流程完全正常；但想了解是否可以在部署镜像前，先用Dockerfile对镜像进行自定义处理，并且通过Helm Chart或YAML配置告知ArgoCD执行这一操作？根据ArgoCD官方文档，这一需求是可以实现的。

具体实现步骤 #

1. 构建带Docker工具的自定义ArgoCD镜像 #

ArgoCD官方镜像默认不包含Docker CLI，需要先构建一个集成了Docker工具的自定义镜像，才能让ArgoCD执行镜像构建操作：

• 编写自定义Dockerfile：

FROM quay.io/argoproj/argocd:latest

# 切换到root用户安装Docker CLI
USER root
RUN apt-get update && apt-get install -y --no-install-recommends docker.io
# 切回argocd用户
USER argocd

• 构建并推送镜像到私有仓库：

docker build -t your-registry/argocd-with-docker:v1 .
docker push your-registry/argocd-with-docker:v1

2. 替换ArgoCD集群镜像 #

更新ArgoCD的部署资源（比如通过Helm values或Kubernetes YAML），将ArgoCD核心组件（如argocd-server、argocd-repo-server）的镜像替换为你刚构建的自定义镜像，同时确保ArgoCD Pod能访问Docker daemon：

• 可以通过挂载宿主机的/var/run/docker.sock到Pod内部，或者在集群内部署Buildkit服务并配置连接。

3. 在应用配置中添加镜像构建逻辑 #

基于Helm Chart的实现

在Helm Chart中添加PreSync钩子，在ArgoCD同步应用前执行镜像构建：

# templates/pre-sync-build-job.yaml
apiVersion: batch/v1
kind: Job
metadata:
  name: {{ .Release.Name }}-pre-build-image
  annotations:
    argocd.argoproj.io/hook: PreSync
    argocd.argoproj.io/hook-delete-policy: HookSucceeded
spec:
  template:
    spec:
      containers:
      - name: build-image
        image: your-registry/argocd-with-docker:v1
        command: ["/bin/sh", "-c"]
        args:
        - |
          # 从仓库拉取基础镜像和Dockerfile（假设已通过ArgoCD同步到应用目录）
          docker build -t your-registry/processed-app-image:{{ .Values.image.tag }} ./path/to/dockerfile-dir
          docker push your-registry/processed-app-image:{{ .Values.image.tag }}
      restartPolicy: OnFailure

随后在Deployment模板中引用构建后的镜像：

spec:
  containers:
  - name: app-container
    image: your-registry/processed-app-image:{{ .Values.image.tag }}

基于原生Kubernetes YAML的实现

直接在ArgoCD应用的YAML配置中定义PreSync钩子Job，执行镜像构建命令，再在Deployment中使用构建完成的镜像即可。

关键注意事项 #

• 权限配置：给ArgoCD Pod配置足够权限，确保能访问Docker daemon、镜像仓库的拉取/推送密钥。
• 构建优化：建议使用Buildkit替代原生Docker构建，通过设置DOCKER_BUILDKIT=1启用，提升构建效率与安全性。
• 超时调整：镜像构建耗时可能较长，需调整ArgoCD的同步超时时间，避免被判定为同步失败。

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