이 문서는 ArgoCD를 운영 관점에서 어떻게 읽어야 하는지 설명하는 가이드다.
ArgoCD는 GitOps 선언을 읽고, 클러스터의 실제 상태를 원하는 상태로 수렴시키는 컨트롤러다.
운영자는 ArgoCD를 통해 아래를 본다.
| 항목 | 운영에서 보는 의미 |
|---|---|
Application |
동기화 단위다. 서비스 하나이거나 인프라 묶음일 수 있다. |
Sync Status |
Git 기준과 live 기준이 같은지 |
Health Status |
리소스가 정상적으로 떠 있는지 |
Source |
어떤 레포 경로를 기준으로 삼는지 |
Destination |
어느 클러스터와 namespace에 적용되는지 |
OutOfSync 하나만 보고 곧바로 장애라고 단정하지 않는다.
운영에서는 항상 아래 둘을 같이 본다.
Sync StatusHealth Status예를 들어 OutOfSync 여도 앱이 정상 동작 중일 수 있고, 반대로 Synced 여도 리소스 health가 깨져 있을 수 있다.
Application 이 어떤 namespace를 관리하는지 본다.source.path 가 어느 overlay 또는 manifest 경로를 가리키는지 본다.즉 ArgoCD는 최종 원인 그 자체보다, 어느 선언과 어느 리소스가 어긋났는지를 찾는 출발점에 가깝다.
무엇을 적용해야 하는가를 본다.실제로 무엇이 떠 있는가를 본다.둘을 같이 봐야 운영 판단이 맞아진다.
GitOps 운영 모델 가이드Kubernetes 기본 구조 가이드Manual 의 배포 확인, sync 확인, 롤백 문서를 본다.