[Ep.24] [Argo CD 성능 최적화 #1] Argo CD 애플리케이션 동기화 최적화 전략

 

🔹 애플리케이션 동기화(Synchronization)란?

Argo CD에서 애플리케이션 동기화(Synchronization) 는 Git 저장소의 선언적 상태와 Kubernetes 클러스터의 실제 상태를 일치시키는 과정입니다.
즉, Git에 정의된 매니페스트를 Kubernetes에 적용하여 GitOps 원칙을 유지하는 핵심 기능입니다.

✅ Argo CD 동기화의 주요 기능
✔ Git의 변경 사항을 감지하고 자동 반영
✔ Kubernetes 리소스의 실제 상태와 원하는 상태를 비교
✔ 변경이 발생하면 자동 또는 수동으로 동기화 실행 가능
✔ Self-Healing을 통해 의도하지 않은 변경 사항 자동 복구 가능

---

🔹 Argo CD 동기화 최적화가 필요한 이유

✅ 빠르고 안정적인 배포를 위해
✔ 불필요한 리소스 업데이트 방지
✔ 동기화 속도 최적화로 배포 시간을 단축

✅ 운영 비용 절감을 위해
✔ 불필요한 API 호출 감소 → Kubernetes API 서버 부담 감소
✔ CI/CD 파이프라인과의 연계를 최적화하여 리소스 효율성 향상

✅ 배포 안정성을 높이기 위해
✔ 동기화 충돌을 최소화하고 예측 가능한 배포 수행
✔ Canary 및 Blue-Green 배포와 함께 최적의 동기화 전략 적용

---

🔹 1. 동기화 정책(Sync Policy) 최적화

Argo CD의 동기화 정책은 자동(Automated) 과 수동(Manual) 두 가지 방식으로 설정할 수 있습니다.
최적화된 설정을 통해 배포를 더 효과적으로 관리할 수 있습니다.

✅ 자동 동기화 활성화 (자동화 배포)

syncPolicy:
  automated:
    prune: true  # 불필요한 리소스를 자동 정리
    selfHeal: true  # Kubernetes 상태가 변경되었을 경우 자동 복구
  syncOptions:
    - CreateNamespace=true  # 네임스페이스가 없으면 자동 생성
    - PrunePropagationPolicy=foreground  # 종속 리소스 삭제 정책 설정
    - PruneLast=true  # 종속 리소스를 마지막에 삭제

✅ 설명:
✔ prune: true → Git에서 제거된 리소스를 Kubernetes에서도 자동 삭제
✔ selfHeal: true → Kubernetes에서 변경된 리소스를 Git 상태로 자동 복구
✔ CreateNamespace=true → 네임스페이스가 없을 경우 자동 생성
✔ PrunePropagationPolicy=foreground → 리소스가 계층적으로 삭제되도록 설정
✔ PruneLast=true → 최상위 리소스를 가장 마지막에 삭제

✅ 적용 방법:

kubectl apply -f argocd-app.yaml
argocd app sync my-app

---

✅ 수동 동기화 설정 (운영 환경에서 안전하게 배포)

운영 환경에서는 수동 승인 후 배포가 진행되도록 설정할 수도 있습니다.

syncPolicy:
  automated: {}  # 자동 동기화 비활성화
  syncOptions:
    - ApplyOutOfSyncOnly=true  # 변경된 리소스만 동기화

✅ 설명:
✔ automated: {} → 자동 동기화 비활성화
✔ ApplyOutOfSyncOnly=true → 변경된 리소스만 동기화

✅ 동기화 수동 실행:

argocd app sync my-app

---

🔹 2. 동기화 웨이브(Sync Waves) 및 훅(Hooks) 활용

✅ 동기화 웨이브(Sync Waves)
동기화 순서를 제어하여 의존성이 있는 리소스를 순차적으로 배포할 수 있습니다.
예를 들어, ConfigMap을 먼저 생성한 후 Deployment를 배포하도록 설정할 수 있습니다.

metadata:
  annotations:
    argocd.argoproj.io/sync-wave: "1"  # 먼저 실행됨

✅ 예제: ConfigMap → Deployment → Service 순으로 배포

# ConfigMap (Sync Wave 1)
apiVersion: v1
kind: ConfigMap
metadata:
  name: app-config
  namespace: my-namespace
  annotations:
    argocd.argoproj.io/sync-wave: "1"
data:
  ENV: "production"
---
# Deployment (Sync Wave 2)
apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-app
  namespace: my-namespace
  annotations:
    argocd.argoproj.io/sync-wave: "2"
spec:
  replicas: 2
  template:
    spec:
      containers:
        - name: my-app
          image: my-image:latest
---
# Service (Sync Wave 3)
apiVersion: v1
kind: Service
metadata:
  name: my-app-service
  namespace: my-namespace
  annotations:
    argocd.argoproj.io/sync-wave: "3"
spec:
  selector:
    app: my-app

✅ 설명:
✔ sync-wave: "1" → ConfigMap을 먼저 배포
✔ sync-wave: "2" → Deployment를 ConfigMap 배포 후 실행
✔ sync-wave: "3" → Service를 마지막에 배포

✅ 동기화 실행:

argocd app sync my-app

---

✅ 동기화 훅(Sync Hooks) 활용
특정 리소스를 배포하기 전후에 PreSync, Sync, PostSync 훅을 실행할 수 있습니다.

apiVersion: batch/v1
kind: Job
metadata:
  name: pre-sync-job
  namespace: my-namespace
  annotations:
    argocd.argoproj.io/hook: PreSync  # 동기화 전에 실행
spec:
  template:
    spec:
      containers:
        - name: init
          image: busybox
          command: ["sh", "-c", "echo 'Running pre-sync job'"]
      restartPolicy: Never

✅ 훅 종류:
✔ PreSync → 동기화 전에 실행 (DB 마이그레이션 등)
✔ Sync → 동기화 과정에서 실행
✔ PostSync → 동기화 후 실행 (알림 전송 등)

---

🔹 3. 애플리케이션 동기화 트러블슈팅

✅ 1️⃣ 동기화 상태 확인

argocd app get my-app

✅ 출력 예시:

Name:               my-app
Project:            default
Sync Status:        OutOfSync  (1 missing, 1 modified)
Health Status:      Healthy

✅ 2️⃣ 특정 리소스만 동기화

argocd app sync my-app --resource deployment/my-app

✅ 3️⃣ 자동 동기화 활성화 여부 확인

argocd app get my-app | grep Automated

✅ 자동 동기화가 꺼져 있으면 다음 명령어로 활성화:

argocd app set my-app --sync-policy automated

---

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

🟢 Argo CD의 동기화는 Git 상태와 Kubernetes 상태를 일치시키는 중요한 과정
🟢 자동 동기화(Automated Sync)를 사용하면 GitOps 원칙을 유지하면서 빠른 배포 가능
🟢 Sync Wave 및 Sync Hooks를 활용하면 배포 순서를 세밀하게 조정 가능
🟢 트러블슈팅을 위해 Argo CD의 동기화 상태를 확인하고 특정 리소스만 개별 동기화 가능

---

추천 태그
쿠버네티스, kubernetes, k8s, gitops, argocd, devops, ci/cd, sync, deployment

이제 **"[Ep.25] [GitOps와 Argo CD의 기초 #25] Argo CD에서 Helm 차트와 Kustomize 최적화"**를 준비하겠습니다. 😊