[Ep.20] [Argo CD 배포 & 자동화 #5] Argo CD Notifications로 Slack 및 이메일 알림 설정

🔹 Argo CD Notifications란?

Argo CD Notifications는 Argo CD에서 발생하는 이벤트(배포 성공, 실패, 동기화 오류 등)를 실시간으로 알림하는 기능입니다.
이를 활용하면 운영자가 배포 상태를 빠르게 파악하고 즉시 대응할 수 있으며,
Slack, 이메일, 웹훅(Webhook) 등 다양한 채널로 알림을 보낼 수 있습니다.

 

✅ Argo CD Notifications의 주요 기능
✔ 애플리케이션 동기화 상태 변경 감지 (Sync 성공, 실패, 충돌 등)
✔ 애플리케이션 헬스 체크 실패 감지 (예: CrashLoopBackOff)
✔ Slack, 이메일, Webhook 등의 알림 채널 지원
✔ 커스텀 알림 템플릿 구성 가능

---

🔹 Argo CD Notifications 설치 및 구성

✅ 1. Argo CD Notifications 설치

Argo CD Notifications는 Argo CD의 확장 기능이므로 Helm을 사용하여 설치합니다.

helm repo add argo https://argoproj.github.io/argo-helm
helm repo update
helm upgrade --install argo-cd argo/argo-cd --namespace argocd --set notifications.enabled=true

 

✅ 설치 확인:

kubectl get pods -n argocd | grep notifications

argocd-notifications-controller-xxxxx   1/1   Running   0     1m

---

✅ 2. Argo CD Notifications 기본 설정

Argo CD Notifications는 ConfigMap과 Secret을 통해 알림 설정을 관리합니다.

📌 ConfigMap 생성 (notifications-config)

apiVersion: v1
kind: ConfigMap
metadata:
  name: argocd-notifications-cm
  namespace: argocd
data:
  context: |
    appName: "ArgoCD"
  templates.app-sync-failed: |
    title: Application {{.app.metadata.name}} 동기화 실패
    body: |
      ❌ {{.app.metadata.name}} 애플리케이션이 동기화에 실패했습니다.
      - **프로젝트**: {{.app.spec.project}}
      - **동기화 상태**: {{.app.status.sync.status}}
      - **건강 상태**: {{.app.status.health.status}}
  subscriptions: |
    - recipients:
        - slack:#deploy-alerts
      triggers:
        - on-sync-failed

 

✅ 설명:
✔ context → 알림에 포함될 기본 정보 설정
✔ templates.app-sync-failed → 동기화 실패 시 알림 메시지 템플릿
✔ subscriptions → 특정 이벤트 발생 시 Slack 채널에 알림

---

✅ 3. Slack 알림 설정

📌 Slack Webhook 설정

Slack 알림을 받기 위해 Webhook을 설정해야 합니다.

1️⃣ Slack Webhook 생성 페이지로 이동
2️⃣ 새로운 Slack App을 생성 후 Incoming Webhooks 활성화
3️⃣ Webhook URL을 복사

---

📌 Slack Webhook을 Kubernetes Secret에 저장

apiVersion: v1
kind: Secret
metadata:
  name: argocd-notifications-secret
  namespace: argocd
stringData:
  slack-webhook-url: "https://hooks.slack.com/services/XXXX/XXXX/XXXX"

 

✅ Secret 적용:

kubectl apply -f argocd-notifications-secret.yaml

---

📌 ConfigMap에 Slack 설정 추가

Slack Webhook을 알림 채널로 추가합니다.

apiVersion: v1
kind: ConfigMap
metadata:
  name: argocd-notifications-cm
  namespace: argocd
data:
  service.slack: |
    webhook: $slack-webhook-url

 

✅ ConfigMap 적용:

kubectl apply -f argocd-notifications-cm.yaml

 

✅ Slack 알림 테스트:

argocd notifications test-service slack

---

✅ 4. 이메일 알림 설정

이메일 알림을 받기 위해 SMTP 서버 정보를 Secret으로 저장합니다.

apiVersion: v1
kind: Secret
metadata:
  name: argocd-notifications-secret
  namespace: argocd
stringData:
  email-username: "example@gmail.com"
  email-password: "app-password"

 

✅ Secret 적용:

kubectl apply -f argocd-notifications-secret.yaml

---

📌 ConfigMap에 이메일 설정 추가

apiVersion: v1
kind: ConfigMap
metadata:
  name: argocd-notifications-cm
  namespace: argocd
data:
  service.email: |
    host: smtp.gmail.com
    port: 587
    username: $email-username
    password: $email-password
    from: "ArgoCD Notifications <example@gmail.com>"

 

✅ ConfigMap 적용:

kubectl apply -f argocd-notifications-cm.yaml

 

✅ 이메일 알림 테스트:

argocd notifications test-service email

---

✅ 5. Argo CD 알림 트리거 설정

다양한 이벤트에 대한 알림을 설정할 수 있습니다.

📌 애플리케이션 동기화 성공/실패 트리거 설정

apiVersion: v1
kind: ConfigMap
metadata:
  name: argocd-notifications-cm
  namespace: argocd
data:
  trigger.on-sync-failed: |
    - description: "애플리케이션 동기화 실패 감지"
      when: "app.status.sync.status == 'OutOfSync'"
      send: [slack, email]
  trigger.on-sync-succeeded: |
    - description: "애플리케이션 동기화 성공 감지"
      when: "app.status.sync.status == 'Synced'"
      send: [slack]

 

✅ ConfigMap 적용:

kubectl apply -f argocd-notifications-cm.yaml

 

✅ 트리거 설정 확인:

argocd notifications trigger list

---

🔹 Argo CD Notifications CLI 명령어 정리

명령어	설명
argocd notifications test-service slack	Slack 알림 테스트
argocd notifications test-service email	이메일 알림 테스트
argocd notifications trigger list	설정된 트리거 목록 확인
argocd notifications trigger enable <TRIGGER>	특정 트리거 활성화
argocd notifications trigger disable <TRIGGER>	특정 트리거 비활성화

---

🔹 결론: 이번 글에서 배운 핵심 내용 정리

🟢 Argo CD Notifications를 활용하면 애플리케이션 배포 상태를 실시간으로 모니터링 가능
🟢 Slack, 이메일, Webhook을 통해 배포 성공/실패 알림을 받을 수 있음
🟢 ConfigMap과 Secret을 활용하여 유연한 알림 설정이 가능함
🟢 자동화된 알림 시스템을 구축하여 GitOps 환경에서 빠르게 이슈를 감지하고 대응 가능