[전환가이드] ArgoCD·FluxCD GitOps 배포를 HelmRelease로 전환하는 방법

문제 상황

• ArgoCD를 Helm template으로 렌더링한 정적 YAML로 배포하면서 버전 업그레이드마다 결과물 전체를 다시 커밋해야 하는 부담
• values 변경 시 diff가 과도하게 커지고, 설정이 한 파일에 몰려 가독성과 관리성이 떨어지는 문제
• valuesFrom 참조, ConfigMap 생성 순서, 기존 리소스 보호, tracking 어노테이션 정리 같은 전환 과정의 함정

해결 방법

• ArgoCD 배포를 HelmRelease로 전환해 선언은 Git에, Helm 라이프사이클은 FluxCD가 담당하는 구조로 변경
• 차트는 Harbor OCI 레지스트리에 올리고, values는 ConfigMap으로 분리해 HelmRelease의 valuesFrom으로 참조
• disableNameSuffixHash와 sync-wave를 활용해 ConfigMap 생성과 HelmRelease 배포 순서를 보장

적용해볼 점

• 버전 업그레이드는 HelmRelease의 version 한 줄 변경으로 단순화
• PR diff에서 실제 변경분만 확인 가능해 운영 노이즈 감소
• 초기 부트스트랩 이후 플랫폼 컴포넌트도 동일한 GitOps 패턴으로 점진 확산 가능