[Ep.22] [Argo CD 보안 & 확장 #2] Argo CD HA(고가용성) 아키텍처 구성

🔹 고가용성(High Availability, HA)이란?

고가용성(HA, High Availability)이란 시스템 장애 시에도 서비스가 지속적으로 운영될 수 있도록 설계하는 방법입니다.
Argo CD는 기본적으로 **단일 인스턴스 모드(Single Instance Mode)**로 실행되지만,
운영 환경에서는 고가용성(HA) 모드를 활성화하여 여러 노드에서 안정적으로 동작하도록 구성하는 것이 중요합니다.

 

✅ 고가용성 구성 시 기대 효과

✔ 단일 장애 지점(Single Point of Failure, SPOF) 제거
✔ 부하 분산(Load Balancing)으로 성능 향상
✔ 자동 복구(Self-Healing) 및 빠른 장애 대응 가능

---

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

Argo CD HA(고가용성) 모드를 활성화하면 다음과 같은 구성 요소가 포함됩니다.

구성 요소	설명
Argo CD API Server	API 요청을 처리하고 UI 및 CLI와 통신
Application Controller	Kubernetes 클러스터와 동기화하는 컨트롤러
Repo Server	Git 저장소에서 매니페스트를 가져오는 서버
Redis	상태 저장 및 캐싱을 위한 데이터 저장소
PostgreSQL	Argo CD의 상태 정보를 저장하는 데이터베이스

 

✅ Argo CD HA 아키텍처 다이어그램

graph LR
  A[User CLI / UI] -->|API Requests| B(Argo CD API Server)
  B -->|State Storage| C[(PostgreSQL Database)]
  B -->|Cache| D[(Redis)]
  B -->|Sync Operations| E(Application Controller)
  E -->|Fetch Configs| F(Repo Server)
  E -->|Deploy Applications| G(Kubernetes Cluster)
  B -->|Load Balancer| H[Ingress / Service]

---

🔹 Argo CD HA 모드 활성화

기본적으로 Argo CD는 단일 인스턴스로 실행되지만, Helm을 사용하여 HA 모드로 배포할 수 있습니다.

✅ 1. Helm을 사용하여 Argo CD HA 모드 배포

helm repo add argo https://argoproj.github.io/argo-helm
helm repo update
helm install argocd argo/argo-cd --namespace argocd --create-namespace \
  --set controller.replicas=2 \
  --set repoServer.replicas=2 \
  --set redis-ha.enabled=true \
  --set server.replicas=2 \
  --set dex.replicas=2

 

✅ 설명:
✔ controller.replicas=2 → Application Controller를 2개 실행하여 장애 대비
✔ repoServer.replicas=2 → Git 매니페스트를 처리하는 Repo Server를 2개 실행
✔ redis-ha.enabled=true → Redis를 고가용성(HA) 모드로 실행
✔ server.replicas=2 → API 서버를 2개 실행하여 부하 분산

 

✅ 설치 확인:

kubectl get pods -n argocd

NAME                                    READY   STATUS    RESTARTS   AGE
argocd-application-controller-0         1/1     Running   0          2m
argocd-application-controller-1         1/1     Running   0          2m
argocd-repo-server-0                    1/1     Running   0          2m
argocd-repo-server-1                    1/1     Running   0          2m
argocd-redis-ha-server-0                1/1     Running   0          2m
argocd-redis-ha-server-1                1/1     Running   0          2m
argocd-server-0                         1/1     Running   0          2m
argocd-server-1                         1/1     Running   0          2m

---

✅ 2. Redis HA 구성 (세션 유지 및 캐싱 개선)

Argo CD는 Redis를 사용하여 세션 및 캐시 데이터를 저장하므로, 고가용성을 위해 Redis HA 모드를 활성화해야 합니다.

 

✅ Redis HA 활성화:

kubectl edit configmap argocd-cm -n argocd

 

✅ 설정 추가:

data:
  redis.enabled: "true"

 

✅ 적용 후 Redis 상태 확인:

kubectl get pods -n argocd -l app.kubernetes.io/name=redis-ha

---

✅ 3. PostgreSQL 외부 DB 연동 (선택 사항)

기본적으로 Argo CD는 내부 SQLite를 사용하지만, HA 환경에서는 PostgreSQL을 사용하는 것이 권장됩니다.

 

✅ PostgreSQL 연동을 위한 Secret 생성

apiVersion: v1
kind: Secret
metadata:
  name: argocd-postgres-config
  namespace: argocd
stringData:
  host: "postgres.example.com"
  database: "argocd"
  username: "argocd"
  password: "securepassword"

 

✅ PostgreSQL 연결 설정 (argocd-cm 수정)

data:
  configManagementPlugins: |
    db.host=postgres.example.com
    db.name=argocd
    db.user=argocd
    db.passwordFromSecret=argocd-postgres-config

 

✅ PostgreSQL 적용 후 Argo CD 재시작:

kubectl rollout restart deployment argocd-server -n argocd

---

🔹 Argo CD HA 모드 운영 팁

✅ 1. Ingress를 활용한 API 서버 부하 분산
HA 환경에서는 Argo CD API 서버 앞에 Ingress 또는 LoadBalancer를 배치하여 트래픽을 분산하는 것이 좋습니다.

 

✅ 2. 애플리케이션 컨트롤러 로깅 활성화
Argo CD 애플리케이션 컨트롤러의 동작을 모니터링하려면 다음 명령어를 사용할 수 있습니다.

kubectl logs -f -l app.kubernetes.io/name=argocd-application-controller -n argocd

 

✅ 3. 상태 확인 및 트러블슈팅
HA 환경에서 Argo CD 상태를 확인하려면 다음 명령어를 사용합니다.

kubectl get pods -n argocd -o wide
kubectl get svc -n argocd
kubectl get endpoints -n argocd

---

🔹 Argo CD HA 운영을 위한 CLI 명령어 정리

명령어	설명
kubectl get pods -n argocd	Argo CD 실행 상태 확인
kubectl get svc -n argocd	Argo CD 서비스 목록 확인
kubectl edit configmap argocd-cm -n argocd	Argo CD 설정 수정
kubectl rollout restart deployment argocd-server -n argocd	Argo CD 서버 재시작
kubectl logs -f -l app.kubernetes.io/name=argocd-application-controller -n argocd	컨트롤러 로그 확인

---

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

🟢 Argo CD HA 모드를 구성하면 장애 발생 시에도 서비스가 중단되지 않고 지속적으로 운영 가능
🟢 Helm을 사용하여 Argo CD를 HA 모드로 배포 가능하며, Redis 및 PostgreSQL 연동으로 안정성을 향상 가능
🟢 Ingress 또는 LoadBalancer를 활용하여 Argo CD API 서버의 트래픽을 효율적으로 분산 가능
🟢 애플리케이션 컨트롤러, Repo Server, Redis를 다중화하여 확장성과 안정성을 확보할 수 있음