[Ep.32] [Argo CD 운영 최적화 #2] Argo CD의 고가용성(HA) 구성 및 장애 대응

🔹 Argo CD의 고가용성(HA)란?

Argo CD는 기본적으로 싱글 인스턴스로 배포되지만,
운영 환경에서는 다중 노드(멀티 인스턴스) 구성을 통해 고가용성(High Availability, HA) 을 보장해야 합니다.

 

 

✅ 고가용성(HA) 아키텍처를 구축하는 이유

 

✔ 단일 장애점(Single Point of Failure, SPOF) 제거
✔ 트래픽 부하 분산 및 성능 최적화
✔ 애플리케이션 배포 중단 방지 및 운영 안정성 강화
✔ 멀티 리전 또는 멀티 클러스터에서 원활한 동작 보장

 

✅ Argo CD HA 아키텍처 구성 요소

구성 요소	설명
Argo CD API 서버	사용자 요청을 처리하고, UI 및 CLI와 상호작용
Argo CD 컨트롤러	Git 상태를 감시하고 Kubernetes 리소스를 동기화
Argo CD 리포지터리 서버	Git 저장소에서 매니페스트를 가져오고 처리
Redis	Argo CD API 서버 및 컨트롤러 간 캐시 공유
External Database (PostgreSQL)	HA 환경에서는 외부 DB(PostgreSQL)를 사용하여 상태 저장

---

🔹 1. Argo CD 고가용성(HA) 아키텍처 구성

✅ Argo CD HA 모드 활성화 방법

Argo CD는 기본적으로 싱글 모드(Single Instance)로 동작하지만,
다음 설정을 적용하면 멀티 인스턴스(HA 모드)로 배포할 수 있습니다.

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: argocd-ha
  namespace: argocd
spec:
  project: default
  source:
    repoURL: https://github.com/example/repo.git
    targetRevision: main
    path: argocd-ha
  destination:
    server: https://kubernetes.default.svc
    namespace: argocd
  syncPolicy:
    automated:
      prune: true
      selfHeal: true

 

✅ 설명:
✔ destination.namespace: argocd → Argo CD를 배포할 네임스페이스 지정
✔ syncPolicy.automated → Git 변경 사항이 자동 반영되도록 설정

 

✅ HA 모드 활성화 시 주요 변경 사항
✔ API 서버(ReplicaSet) 복제 → replicas: 2 이상으로 설정하여 다중 인스턴스 구성
✔ Argo CD 컨트롤러 HA 모드 적용 → controller.replicas: 2 이상
✔ Argo CD 리포지터리 서버 HA 모드 적용 → repoServer.replicas: 2 이상
✔ Redis 및 External DB(PostgreSQL) 연동

---

🔹 2. Argo CD HA 구성 방법 (Helm Chart 사용)

✅ Helm을 사용한 HA 모드 배포 예제

apiVersion: v2
name: argocd-ha
description: High Availability deployment of Argo CD
version: 1.0.0
dependencies:
  - name: argo-cd
    version: 5.17.0
    repository: https://argoproj.github.io/argo-helm
    values:
      controller:
        replicas: 3  # 컨트롤러 HA 모드 활성화
      repoServer:
        replicas: 2  # 리포지터리 서버 복제
      applicationSet:
        enabled: true  # ApplicationSet 기능 활성화
      dex:
        enabled: false  # SSO 인증이 필요 없는 경우 비활성화
      redis:
        enabled: true  # 캐싱을 위한 Redis 활성화
      postgresql:
        enabled: true  # 외부 DB 사용 활성화

 

✅ 설명:
✔ controller.replicas: 3 → Argo CD 컨트롤러를 3개 복제하여 HA 구성
✔ repoServer.replicas: 2 → 리포지터리 서버를 2개로 복제
✔ redis.enabled: true → API 서버 간 캐싱을 위해 Redis 활성화
✔ postgresql.enabled: true → 외부 데이터베이스(PostgreSQL) 연동

 

✅ Helm을 사용하여 Argo CD HA 배포 적용

helm install argocd-ha -f values-ha.yaml argo-cd/argo-cd -n argocd

 

✅ 배포된 Argo CD HA 상태 확인

kubectl get pods -n argocd

 

✅ 출력 예시:

NAME                                 READY   STATUS    RESTARTS   AGE
argocd-server-0                      1/1     Running   0          5m
argocd-server-1                      1/1     Running   0          5m
argocd-repo-server-0                 1/1     Running   0          5m
argocd-repo-server-1                 1/1     Running   0          5m
argocd-controller-0                  1/1     Running   0          5m
argocd-controller-1                  1/1     Running   0          5m
argocd-redis-0                       1/1     Running   0          5m
argocd-postgresql-0                  1/1     Running   0          5m

---

🔹 3. Argo CD 장애 대응 전략

✅ 1️⃣ API 서버 다운 시 복구 방법
✔ HA 모드에서는 다른 API 서버가 계속 운영되므로 자동 복구됨
✔ 하지만, 모든 API 서버가 다운되면 다음 명령어로 복구

kubectl rollout restart deployment argocd-server -n argocd

 

✅ 2️⃣ 컨트롤러 다운 시 복구 방법

kubectl rollout restart deployment argocd-application-controller -n argocd

 

✅ 3️⃣ 리포지터리 서버 다운 시 복구 방법

kubectl rollout restart deployment argocd-repo-server -n argocd

 

✅ 4️⃣ PostgreSQL 또는 Redis 장애 발생 시 해결 방법

✔ Redis 장애 발생 시:

kubectl rollout restart statefulset argocd-redis -n argocd

 

✔ PostgreSQL 장애 발생 시:

kubectl rollout restart statefulset argocd-postgresql -n argocd

---

🔹 4. Argo CD HA 운영 시 고려할 점

✅ 1️⃣ HPA(Horizontal Pod Autoscaler) 적용하여 자동 확장
✔ API 서버 및 컨트롤러의 CPU 사용량이 증가하면 자동 확장하도록 설정 가능

kubectl autoscale deployment argocd-server --cpu-percent=50 --min=2 --max=5 -n argocd

 

✅ 2️⃣ Argo CD 로그 및 이벤트 모니터링
✔ Prometheus 및 Grafana를 활용하여 API 서버 및 컨트롤러의 메트릭 모니터링
✔ Loki를 사용하여 로그 분석 수행

 

✅ 3️⃣ 운영 환경에 맞는 스토리지 클래스 선택
✔ ReadWriteMany(RWX) 지원 스토리지를 사용하여 다중 Pod 간 공유 가능하도록 구성

 

✅ 4️⃣ 데이터베이스 백업 및 복원 전략
✔ PostgreSQL 사용 시 정기적인 백업 및 복원 테스트 필수
✔ pg_dump를 활용한 백업 예제

pg_dump -h <DB_HOST> -U <DB_USER> -d argocd > argocd_backup.sql

---

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

🟢 Argo CD HA 모드를 구성하면 API 서버, 컨트롤러, 리포지터리 서버를 다중 인스턴스로 운영 가능
🟢 Helm을 활용하여 Argo CD를 HA 모드로 배포하고 Redis, PostgreSQL과 연동하여 확장 가능
🟢 Argo CD 장애 발생 시 kubectl rollout restart 명령어를 활용하여 신속하게 복구 가능
🟢 운영 환경에 맞는 자동 확장(HPA), 모니터링, 데이터 백업 전략을 고려해야 안정적인 운영 가능