ArgoCD sync失败时如何通过Kubernetes配置发送邮件通知

完全可以实现，不需要定制开发，通过Kubernetes原生配置配合ArgoCD生态能力就能落地，常用有两种成熟落地方案：

ArgoCD v2.3及以上版本默认内置通知能力，不需要额外部署第三方服务，只需要修改ArgoCD对应的配置资源即可完成配置，运维成本最低：

• 第一步：配置SMTP邮件服务参数。编辑argocd-cm这个ConfigMap，在data段填入邮件服务的连接信息，敏感凭证建议引用Kubernetes Secret存储，不要明文硬编码：

data:
  notifiers.email.smtp.host: "内部SMTP服务地址"
  notifiers.email.smtp.port: "465"
  notifiers.email.smtp.username: "告警发件人账号"
  notifiers.email.smtp.password: "$smtp-auth-secret:password" # 引用预先存在的Secret里的密码字段
  notifiers.email.smtp.from: "argocd-alert@公司域名"
  notifiers.email.smtp.ssl: "true"

• 第二步：配置同步失败触发规则。编辑argocd-notifications-cm ConfigMap，添加同步失败的触发器，匹配应用操作状态为Error/Failed的场景，同时支持自动读取应用上的注解获取对应负责人邮箱，不需要全局写死收件人：

trigger.on-sync-failed:
  enabled: true
  condition: app.status.operationState.phase in ['Error', 'Failed']
  send: [sync-fail-notice]
  recipientAnnotation: argocd-notifications/email-recipients

• 第三步：定义邮件通知模板，在同一个ConfigMap里配置邮件正文模板，把失败应用名、错误日志、同步时间、内部ArgoCD应用地址等关键信息放到模板里，触发规则命中后就会自动给对应负责人发邮件。
  提示：给ArgoCD应用加注解时，直接把对应负责的用户/团队邮箱填入argocd-notifications/email-recipients字段即可，支持填多个邮箱，用逗号分隔。

如果集群已经部署了Prometheus+AlertManager的全链路监控栈，可以直接复用现有告警链路实现，不需要单独维护ArgoCD的通知配置：

• 第一步：确认ArgoCD的metrics端口正常暴露，ArgoCD默认会自带暴露argocd_app_sync_status指标，同步失败场景下对应指标值为1，可以直接被Prometheus采集。
• 第二步：配置Prometheus告警规则，匹配argocd_app_sync_status{sync_status="Failed"} == 1的指标作为触发条件，规则里可以保留应用所属业务线、负责人标签等信息。
• 第三步：给ArgoCD应用打上负责人标签（比如contact-email: zhangsan@公司域名、team: 业务研发组），在AlertManager里配置路由规则，根据标签匹配对应的邮件接收人，复用现有SMTP配置发告警邮件即可。
• 扩展：如果需要获取更详细的同步失败上下文（比如具体是哪个资源创建报错、是权限问题还是资源配额不足），可以在集群部署事件采集组件，捕获Kubernetes API里ArgoCD抛出的同步失败事件，匹配关键字后触发告警，比纯metrics告警的信息更全。

• 所有敏感凭证比如SMTP密码、第三方服务密钥都要用Kubernetes Secret存储，不要明文写在ConfigMap里，避免配置泄露。
• 告警规则里建议配置抑制策略，比如同一个应用连续同步失败时，设置15-30分钟的重复告警间隔，避免短时间内重复发邮件造成轰炸。
• 收件人匹配规则可以和集群内已有的应用标签体系对齐，比如按业务线标签自动映射对应团队的公共邮箱，减少每个应用单独配置收件人的工作量。

内容的提问来源于stack exchange，提问作者Karthiknathan.C