Argo CD 通知服务实战：同步状态与镜像变更监控-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01122/article/details/148363035

Argo CD 通知服务实战：同步状态与镜像变更监控

argo-cd Argo CD 是一个声明式 Kubernetes 应用部署工具，可实现应用程序的自动化部署和版本控制。 * 提供 Kubernetes 应用的自动化部署和版本控制功能，支持多种部署策略，简化 Kubernetes 应用管理。 * 有什么特点：声明式部署、支持多种部署策略、简化 Kubernetes 应用管理。项目地址: https://gitcode.com/gh_mirrors/ar/argo-cd

前言

在现代GitOps实践中，及时获取应用部署状态和变更信息至关重要。Argo CD作为领先的GitOps工具，其通知服务(Notifications)功能可以帮助我们构建强大的监控和告警系统。本文将深入探讨如何利用Argo CD通知服务实现应用同步状态监控和镜像变更追踪。

基础概念

Argo CD通知服务由三个核心组件构成：

触发器(Triggers)：定义何时发送通知的条件
模板(Templates)：定义通知内容的格式
服务(Services)：定义通知发送的渠道（如Webhook、Slack等）

同步状态监控实现

Webhook配置

要实现同步状态监控，首先需要配置Webhook接收器：

apiVersion: v1
kind: ConfigMap
metadata:
  name: argocd-notifications-cm
data:
  service.webhook.on-deployed-webhook: |
    url: <your-webhook-url>
    headers:
    - name: "Content-Type"
      value: "application/json"

  template.on-deployed-template: |
    webhook:
      on-deployed-webhook:
        method: POST
        body: |
          {{toJson .app.status.operationState.syncResult}}

  trigger.on-deployed-trigger: |
    when: app.status.operationState.phase in ['Succeeded'] and app.status.health.status == 'Healthy'
    oncePer: app.status.sync.revision
    send: [on-deployed-template]

关键配置解析

触发器条件：当应用同步成功(Succeeded)且健康状态为Healthy时触发
去重机制：oncePer确保每个修订版本只通知一次
数据格式：将完整的同步结果以JSON格式发送

应用订阅配置

在Application资源中添加注解以订阅通知：

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  annotations:
    notifications.argoproj.io/subscribe.on-deployed-trigger.on-deployed-webhook: ""

同步结果分析

Webhook接收到的数据包含丰富信息：

{
  "resources": [
    {
      "group": "apps",
      "hookPhase": "Running",
      "images": ["nginx:1.27.1"],
      "kind": "Deployment",
      "message": "deployment.apps/test configured",
      "name": "test",
      "namespace": "argocd",
      "status": "Synced",
      "syncPhase": "Sync",
      "version": "v1"
    }
  ],
  "revision": "f3937462080c6946ff5ec4b5fa393e7c22388e4c"
}

通过分析这些数据，我们可以：

识别变更的资源（message字段显示"configured"或"unchanged"）
获取部署的容器镜像版本（images数组）
了解资源同步状态和阶段

镜像变更监控进阶

Slack通知集成

将同步信息发送到Slack可以提升团队协作效率：

apiVersion: v1
kind: ConfigMap
metadata:
  name: argocd-notifications-cm
data:
  service.slack: |
    token: <your-slack-bot-token>

  template.on-deployed-template: |
    slack:
      message: |
        *Deployment Notification*
        *Application:* `{{.app.metadata.name}}`
        *Namespace:* `{{.app.spec.destination.namespace}}`
        *Revision:* `{{.app.status.sync.revision}}`
        *Deployed Images:*
          {{- range $resource := .app.status.operationState.syncResult.resources -}}
            {{- range $image := $resource.images -}}
              - "{{$image}}"
            {{- end }}
          {{- end }}