GitOps with ArgoCD

GitOps?

GitOps는 선언적 인프라 및 애플리케이션 구성을 위해 Git을 SSOT(Single Source of Truth)로 활용하는 일련의 실천 방식이다. Git을 중앙 저장소로 사용함으로써 팀은 애플리케이션 제공 프로세스를 간소화하고, 배포를 자동화하며, 협업을 개선할 수 있다. GitOps라는 용어는 Weaveworks에서 처음 제안했으며, 이후 DevOps 커뮤니티에서 널리 채택되었다.

GitOps의 네 가지 핵심 원칙

1. 선언적 구성(Declarative Configuration)

• 모든 리소스와 구성을 선언형 방식으로 정의하여 시스템의 원하는 상태를 쉽게 관리하고 이해할 수 있도록 한다.
• YAML, JSON, HCL 등으로 인프라와 애플리케이션, 의존성을 기술한다.

2. 버전 관리(Version Control)

• 모든 구성 변경 사항을 Git 저장소에 버전 관리하여 변경 이력을 명확히 남긴다.
• 롤백이 용이하고 감사(audit)가 강화되어 시스템 상태가 항상 재현 가능하고 추적 가능하도록 보장한다.

3. 자동 동기화(Automated Synchronization)

• Git 저장소에 정의된 원하는 상태를 클러스터의 실제 상태와 자동으로 동기화한다.
• 불일치가 감지되면 자동으로 수정하거나 수동 개입을 요청하여 환경 간 일관성을 유지하고 휴먼 에러를 줄인다.

4. 지속적 피드백(Continuous Feedback)

• 모니터링 및 관측(Observability) 도구로 실제 상태를 원하는 상태와 비교하여 지속적 피드백을 제공한다
• 빠른 문제 식별 및 해결, 프로세스 최적화에 기여한다.

GitOps의 주요 이점

1. 생산성 향상 : 배포 자동화와 코드형 인프라(IaC) 관리로 수작업을 줄여 개발·운영팀의 시간을 절약한다.
2. 협업 개선 : 중앙 Git 저장소를 통해 변경 사항을 Pull Request로 검토하고, 명확한 이력을 유지하며 지식 공유와 공동 소유를 촉진한다.
3. 보안 강화 : Git의 접근 제어, 감사 로그, 암호화 서명 기능이 인프라 무결성을 보장하고, 애플리케이션 코드와 분리된 관리로 공격 표면을 최소화한다.
4. 신속한 복구 : 언제든지 이전의 안정된 상태로 롤백할 수 있어 다운타임과 리스크를 최소화하며, 변경 이력을 통해 원인 분석과 사고 대응이 쉬워진다.

실무에서의 활용

GitOps는 ArgoCD, Flux CD, Jenkins X 등과 같은 도구를 이용해 원하는 상태와 실제 상태의 동기화를 자동화한다. 이들 도구는 Git 저장소의 변경을 감시하고 배포 파이프라인을 트리거하여, 클러스터 내 실제 상태가 항상 원하는 상태와 일치하도록 지속 관리한다.

실제 예시

전자상거래 애플리케이션의 여러 마이크로서비스가 쿠버네티스 클러스터에서 운영된다고 가정해 보자. 개발팀이 한 마이크로서비스 코드를 업데이트하고 Git에 푸시하면, ArgoCD 같은 GitOps 도구가 이를 감지하여 자동으로 배포 파이프라인을 실행한다. 업데이트된 서비스가 클러스터에 배포되고 필요한 구성 변경이 적용된다. 이 과정 전반에 걸쳐 모니터링 도구가 피드백을 제공해 시스템이 항상 원하는 상태를 유지하도록 돕는다.

• GitOps는 Git을 단일 진실 소스로 활용해 선언적 인프라·애플리케이션 구성을 관리하는 방법론.
• 핵심 원칙: 선언적 구성, 버전 관리, 자동 동기화, 지속적 피드백
• 주요 이점: 생산성 향상, 협업 개선, 보안 강화, 빠른 복구
• 도구: ArgoCD, Flux CD, Jenkins X 등으로 Git ↔ 클러스터 동기화 자동화
• 실례: 전자상거래 마이크로서비스가 코드 변경 시 자동 배포 및 모니터링으로 안정적 운영

ArgoCD?

ArgoCD는 Kubernetes를 위한 선언적 GitOps 연속 배포(Continuous Delivery) 도구다. Git을 SSOT(Single Source of Truth)로 사용하여 Kubernetes 애플리케이션의 배포 관리와 동기화를 자동화하도록 설계되었다. ArgoCD를 사용하면 여러 Kubernetes 환경을 관리하고, 애플리케이션의 실제 상태가 Git 저장소에 정의된 원하는 상태와 항상 일치하도록 보장할 수 있다.

주요 기능

ArgoCD의 주요 기능은 다음과 같다.

1. 선언적·버전 관리(Declarative & Versioned) : Git을 SSOT(Single Source of Truth)로 삼아 애플리케이션 구성을 선언형으로 관리하며, 모든 변경 사항을 Git에서 버전 관리한다.
2. 다중 클러스터 지원(Multi‐cluster Support) : 개발·스테이징·운영 등 서로 다른 환경의 여러 Kubernetes 클러스터에 애플리케이션을 배포하고 관리할 수 있다.
3. 자동 동기화 및 롤백(Automated Sync & Rollbacks) : Git 저장소 변경을 지속적으로 모니터링해 자동으로 애플리케이션을 동기화하며, 필요 시 이전 버전으로 자동 또는 수동 롤백을 지원한다.
4. 플러그형 배포 전략(Pluggable Deployment Strategies) : 블루/그린(Blue-Green), 카나리(Canary), 롤링 업데이트(Rolling Update) 등 다양한 배포 전략을 플러그인으로 활용할 수 있다.
5. 확장성(Extensibility) : CRD(Custom Resource Definition), Helm Chart, Kustomize 등 Kubernetes 네이티브 도구와 프레임워크를 손쉽게 통합·확장할 수 있다.

ArgoCD 아키텍처 및 동작 흐름

ArgoCD는 클라이언트–서버 아키텍처로 구성된다.

• API 서버(ArgoCD API Server): 사용자 인증 및 UI/API 엔드포인트를 제공한다.
• 리포지토리 서버(Repository Server): Git 저장소의 매니페스트를 가져와 캐싱한다.
• 애플리케이션 컨트롤러(Application Controller): 실제 상태를 모니터링하고 Git에 정의된 원하는 상태와 동기화한다.
• CLI(argo CD CLI): 애플리케이션 생성·업데이트·삭제 등 다양한 작업을 커맨드라인에서 수행할 수 있다.

GitOps 워크플로우에서 ArgoCD의 동작 흐름은 다음과 같다.

1. 개발자가 Git 저장소에 애플리케이션 매니페스트를 수정·푸시하고 Pull Request를 생성한다.
2. 검토 후 승인된 변경 사항이 메인 브랜치에 머지된다.
3. ArgoCD가 Git 저장소 변화를 감지하고 Kubernetes 클러스터에 자동으로 동기화를 수행한다.
4. 모니터링 도구가 실제 상태를 지속적으로 관찰하며 피드백을 제공한다.

사용 이점

ArgoCD를 사용하면 다음과 같은 이점을 얻을 수 있다.

• 배포 간소화: 배포 자동화로 수작업을 줄이고 휴먼 에러를 최소화해 팀이 기능 개발에 집중할 수 있다.
• 협업 강화: Git 기반 중앙 저장소에서 Pull Request로 변경을 검토·관리하며 투명한 이력과 책임 소재를 확보한다.
• 보안 향상: Git의 접근 제어·감사 로그·암호화 서명을 활용해 인프라 무결성을 보장하고, 애플리케이션 코드와 구성을 분리해 보안 위험을 줄인다.
• 신속한 사고 대응: 전체 변경 이력을 바탕으로 빠른 원인 분석이 가능하며, 필요 시 이전 상태로 즉시 롤백해 다운타임을 최소화한다.
• 확장성: 다중 클러스터 배포 지원을 통해 인프라 규모가 커져도 일관성 있게 관리할 수 있다.

정리하자면 아래와 같다.

• ArgoCD는 Git을 SSOT(Single Source of Truth)로 사용해 Kubernetes 애플리케이션을 선언적·버전 관리 방식으로 배포하는 GitOps 도구다.
• 아키텍처는 API 서버, 리포지토리 서버, 애플리케이션 컨트롤러, CLI로 구성된다.
• 핵심 기능: 다중 클러스터 지원, 자동 동기화·롤백, 다양한 배포 전략, 확장성(Helm, Kustomize 등)
• GitOps 워크플로우: 코드 변경 → Pull Request → 머지 → ArgoCD 자동 동기화 → 모니터링 및 피드백
• 주요 장점: 배포 간소화, 협업 강화, 보안 향상, 신속한 사고 대응, 확장성 확보

왜 GitOps와 ArgoCD일까?

GitOps를 ArgoCD와 함께 사용하는 이유와 Kubernetes 기반 애플리케이션 관리에서 얻을 수 있는 이점은 다음과 같다.
 
조직이 클라우드 네이티브 기술과 컨테이너화를 도입함에 따라 복잡한 인프라와 애플리케이션 배포를 관리하는 일이 큰 과제가 되었다. 전통적인 배포 방식은 현대 환경에서 요구되는 자동화, 일관성, 신뢰성을 충분히 제공하지 못할 때가 많다. GitOps는 Git을 SSOT(Single Source of Truth)로 삼아 선언적 인프라 관리를 적용함으로써 이러한 문제를 해결한다. GitOps는 선언적 인프라에 대해 Git을 활용하고 변경 이력을 명확히 기록하여 버전 관리를 제공한다.
 
ArgoCD가 GitOps 워크플로우 구현을 위한 인기 있는 선택인 이유는 다음과 같다.

• Kubernetes 네이티브(Kubernetes Native) : ArgoCD는 Kubernetes를 위해 특별히 설계되어, Kubernetes 기반 애플리케이션 관리를 최적화한다.
• 자동화된 배포(Automated Deployments) : Git 저장소에 정의된 원하는 상태를 지속적으로 감시하고 자동으로 동기화하여 수작업 개입과 휴먼 에러를 줄인다.
• 다양한 구성 관리 도구 지원(Configuration Management Tools) : Helm, Kustomize, Json.net 등 인기 있는 Kubernetes 구성 관리 도구와 원활히 통합되어 복잡한 애플리케이션 구성을 쉽게 관리할 수 있다.
• 보안 및 규정 준수 강화(Security & Compliance) : Git을 단일 소스로 사용해 변경 이력을 명확히 하고, 액세스 제어 및 암호화 서명 기능을 활용해 인프라 무결성을 보장함으로써 규정 준수 요구사항을 충족할 수 있다.
• 협업 및 투명성 촉진(Collaboration & Transparency) : 애플리케이션 구성을 Git 저장소에 중앙 집중화하여 개발·운영팀 모두 시스템 상태를 명확히 파악할 수 있게 함으로써 협업을 강화한다.