[Ep.11] [Argo CD 운영 #6] Argo CD에서 동기화(Sync) 및 배포 전략 최적화

🔹 Argo CD에서 동기화(Sync)란?

Argo CD의 동기화(Sync) 기능은 GitOps 원칙을 기반으로 Kubernetes 애플리케이션을 Git 상태와 일치시키는 프로세스입니다.
Git 저장소에서 선언된 상태와 Kubernetes 클러스터의 실제 상태를 비교하여,
필요한 경우 자동 또는 수동으로 변경 사항을 적용할 수 있습니다.

 

✅ 동기화(Sync)의 핵심 개념

✔ Git 저장소에 선언된 매니페스트가 원본(Source of Truth) 역할
✔ Git 상태와 Kubernetes 클러스터의 상태를 지속적으로 비교
✔ 불일치 발생 시 자동 또는 수동으로 동기화 가능
✔ 롤백(Rollback), Prune(정리), Self-Healing 등의 기능 지원

---

🔹 Argo CD 동기화 상태(Sync Status) 이해하기

Argo CD는 애플리케이션의 동기화 상태를 다음과 같이 분류합니다.

Sync 상태	설명
Synced	애플리케이션이 Git 상태와 동일
OutOfSync	애플리케이션이 Git 상태와 불일치
Unknown	애플리케이션 상태를 확인할 수 없음

✅ 1. Synced (동기화됨)

• 애플리케이션의 모든 Kubernetes 리소스가 Git 저장소의 매니페스트와 동일한 상태
• 이 상태에서는 Kubernetes 클러스터의 변경 사항이 없으며, 배포가 안정적으로 유지됨

✅ 2. OutOfSync (동기화되지 않음)

• Git 저장소의 변경 사항이 Kubernetes 클러스터에 반영되지 않은 상태
• 신규 리소스 추가, 매니페스트 수정, 리소스 삭제 등이 발생했을 가능성이 있음
• argocd app sync 명령어 또는 UI에서 "SYNC" 버튼을 클릭하여 동기화 가능

✅ 3. Unknown (알 수 없음)

• 애플리케이션 상태를 가져올 수 없는 경우 발생
• 네트워크 문제 또는 접근 권한 이슈로 인해 클러스터와 연결이 끊어졌을 가능성이 있음

---

🔹 Argo CD 동기화 정책(Sync Policy) 설정

Argo CD에서는 동기화를 자동으로 수행할지, 수동으로 관리할지 설정할 수 있습니다.
이를 위해 syncPolicy 옵션을 활용하여 자동 동기화(Automated Sync), Prune(정리), Self-Healing(자동 복구) 설정을 조정할 수 있습니다.

✅ 1. 자동 동기화(Automated Sync) 설정

자동 동기화를 활성화하면, Git 저장소의 변경 사항이 감지될 때마다 자동으로 Kubernetes에 반영됩니다.

syncPolicy:
  automated:
    prune: true  # Git에서 삭제된 리소스를 Kubernetes에서도 자동 삭제
    selfHeal: true  # Kubernetes 리소스가 변경되었을 경우 원래 상태로 자동 복구
  syncOptions:
    - CreateNamespace=true  # 네임스페이스가 없을 경우 자동 생성
    - PrunePropagationPolicy=foreground  # Prune 동작 방식 설정
    - PruneLast=true  # 삭제 작업을 마지막에 실행

 

✅ 설명:

• prune: true → Git에서 삭제된 리소스는 Kubernetes에서도 삭제됨
• selfHeal: true → Kubernetes 리소스가 변경되면 Git 상태로 자동 복구
• CreateNamespace=true → 네임스페이스가 없으면 자동 생성
• PrunePropagationPolicy=foreground → 상위 리소스를 먼저 삭제한 후 하위 리소스를 삭제
• PruneLast=true → 삭제 작업을 마지막에 실행

---

✅ 2. 수동 동기화(Manual Sync) 설정

자동 동기화를 비활성화하면, Git 변경 사항이 있어도 직접 수동 동기화해야 반영됩니다.
이 설정은 운영 환경에서 변경 사항을 수동으로 검토 후 반영할 때 유용합니다.

syncPolicy:
  automated: {}

 

CLI를 사용한 수동 동기화:

argocd app sync example-app

 

UI에서 동기화 방법:
1️⃣ Argo CD 웹 UI에서 애플리케이션 선택
2️⃣ "SYNC" 버튼 클릭
3️⃣ 원하는 동기화 옵션을 선택하여 실행

---

🔹 Argo CD 동기화 옵션 최적화

✅ 1. Prune(정리) 설정

Prune 기능을 활성화하면, Git 저장소에서 삭제된 리소스가 Kubernetes에서도 자동 삭제됩니다.

syncPolicy:
  automated:
    prune: true

Prune 기능을 사용하면 불필요한 리소스가 유지되지 않도록 방지할 수 있습니다.

---

✅ 2. Self-Healing(자동 복구) 설정

Self-Healing 기능을 사용하면, Kubernetes 리소스가 직접 변경되었을 경우 자동으로 Git 상태로 복구됩니다.

syncPolicy:
  automated:
    selfHeal: true

 

✅ 예제 시나리오
1️⃣ 운영 중인 애플리케이션의 replicas 값을 수동으로 변경
2️⃣ Argo CD가 Git과 불일치 상태를 감지 (OutOfSync)
3️⃣ Self-Healing 기능이 활성화된 경우, 자동으로 Git 상태로 복원됨

---

🔹 Argo CD 동기화 CLI 명령어 정리

명령어	설명
argocd app list	등록된 애플리케이션 목록 조회
argocd app get <APP>	애플리케이션 상세 상태 확인
argocd app sync <APP>	애플리케이션 동기화 실행
argocd app rollback <APP> <VERSION>	특정 버전으로 롤백
argocd app delete <APP>	애플리케이션 삭제

 

✅ 자동 동기화 확인:

argocd app get example-app

 

✅ 수동 동기화 실행:

argocd app sync example-app

 

✅ 롤백 실행:

argocd app rollback example-app 2

---

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

🟢 Argo CD의 동기화(Sync) 기능은 GitOps 기반 Kubernetes 배포의 핵심 요소
🟢 애플리케이션의 동기화 상태(Synced, OutOfSync, Unknown)를 지속적으로 모니터링 가능
🟢 자동 동기화(Automated Sync) 설정을 통해 Git 변경 사항을 Kubernetes에 자동 반영 가능
🟢 Prune 및 Self-Healing 기능을 활용하여 불필요한 리소스를 정리하고, Kubernetes 상태를 Git과 일치하도록 유지 가능
🟢 CLI 및 UI를 활용하여 애플리케이션을 수동으로 동기화하거나 롤백 수행 가능