[Ep.25] [Argo CD 성능 최적화 #2] Argo CD에서 Helm 차트와 Kustomize 최적화

🔹 Helm과 Kustomize란?

Helm과 Kustomize는 Kubernetes 애플리케이션 배포를 위한 대표적인 도구입니다.
둘 다 Kubernetes 매니페스트를 효율적으로 관리하고 배포하는 기능을 제공하지만, 사용 방식이 다릅니다.

 

✅ Helm과 Kustomize 비교

기능	Helm	Kustomize
템플릿화 지원	✅ (values.yaml)	❌ (Patch 방식)
환경별 설정 관리	✅ (Helm Values)	✅ (Overlay)
패키지 관리	✅ (Helm Chart)	❌ (패키지 없음)
GitOps 친화적	✅	✅
Argo CD 연동	✅	✅

 

✅ 사용 추천 가이드

✔ Helm → 패키지 형태로 Kubernetes 애플리케이션을 배포하고 재사용성을 극대화할 때 적합
✔ Kustomize → 기존 YAML 매니페스트를 유지하면서 환경별 차이만 반영하고 싶을 때 적합

---

🔹 1. Argo CD에서 Helm을 활용한 배포

Helm을 사용하면 애플리케이션을 Chart 형태로 패키징하여 배포할 수 있습니다.
Argo CD는 Helm을 네이티브하게 지원하며, GitOps 방식으로 Git 저장소의 Helm 차트를 읽어와 자동 배포할 수 있습니다.

✅ Helm을 사용한 Argo CD Application 리소스 예제

apiVersion: argoproj.io/v1alpha1  # Argo CD의 API 버전
kind: Application  # Argo CD에서 관리하는 애플리케이션
metadata:
  name: example-app  # 애플리케이션 이름
  namespace: argocd  # Argo CD 네임스페이스
spec:
  project: default  # Argo CD에서 관리하는 프로젝트 지정

  source:
    repoURL: https://github.com/example/repo.git  # Git 저장소 URL
    targetRevision: main  # 사용할 Git 브랜치
    path: helm/example-app  # Helm 차트가 위치한 경로
    helm:
      releaseName: example-app  # Helm 릴리스 이름
      valueFiles:
        - values.yaml  # 기본 값 파일
        - values-prod.yaml  # 운영 환경 값 파일 추가

  destination:
    server: https://kubernetes.default.svc  # 배포할 Kubernetes 클러스터
    namespace: example-app  # 배포될 네임스페이스

  syncPolicy:
    automated:
      prune: true  # Git에서 삭제된 리소스를 Kubernetes에서도 자동 삭제
      selfHeal: true  # Kubernetes 리소스가 변경되었을 경우 Git 상태로 자동 복구

 

✅ 설명:

• source.repoURL → Helm 차트가 저장된 Git 저장소
• source.path → Git 저장소 내에서 Helm 차트가 위치한 경로
• helm.releaseName → Helm 릴리스 이름 설정
• helm.valueFiles → 여러 개의 Values 파일을 적용하여 환경별 설정 가능
• syncPolicy.automated → 자동 배포 및 Self-Healing 활성화

✅ Helm 차트 배포 확인:

argocd app get example-app

 

✅ Helm 차트 동기화 실행:

argocd app sync example-app

---

🔹 2. Argo CD에서 Kustomize를 활용한 배포

Kustomize는 기본 YAML 파일을 유지하면서 환경별로 필요한 설정만 Patch 방식으로 적용할 수 있도록 해줍니다.

✅ Kustomize를 사용한 Argo CD Application 리소스 예제

apiVersion: argoproj.io/v1alpha1  # Argo CD의 API 버전
kind: Application  # Argo CD에서 관리하는 애플리케이션
metadata:
  name: example-app  # 애플리케이션 이름
  namespace: argocd  # Argo CD 네임스페이스
spec:
  project: default  # Argo CD에서 관리하는 프로젝트 지정

  source:
    repoURL: https://github.com/example/repo.git  # Git 저장소 URL
    targetRevision: main  # 사용할 Git 브랜치
    path: kustomize/overlays/prod  # Kustomize 오버레이(운영 환경)

  destination:
    server: https://kubernetes.default.svc  # 배포할 Kubernetes 클러스터
    namespace: example-app  # 배포될 네임스페이스

  syncPolicy:
    automated:
      prune: true  # Git에서 삭제된 리소스를 Kubernetes에서도 삭제
      selfHeal: true  # Kubernetes 리소스가 변경되었을 경우 Git 상태로 자동 복구

 

✅ 설명:

• source.path → Git 저장소 내에서 Kustomize 오버레이가 위치한 경로
• syncPolicy.automated → 자동 배포 및 Self-Healing 활성화

✅ Kustomize 적용된 배포 확인:

argocd app get example-app

 

✅ Kustomize 기반 동기화 실행:

argocd app sync example-app

---

🔹 3. Helm과 Kustomize를 함께 사용하는 방법

Helm과 Kustomize를 함께 사용하여 Helm 차트의 기본 설정을 유지하면서 환경별로 추가적인 설정을 적용할 수도 있습니다.

✅ Helm + Kustomize를 활용한 Argo CD Application 리소스 예제

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: example-app
  namespace: argocd
spec:
  project: default

  source:
    repoURL: https://github.com/example/repo.git
    targetRevision: main
    path: kustomize/overlays/prod  # Kustomize가 적용된 Helm 차트 위치
    helm:
      releaseName: example-app
      valueFiles:
        - values.yaml  # 기본 Helm values 파일

  destination:
    server: https://kubernetes.default.svc
    namespace: example-app

  syncPolicy:
    automated:
      prune: true
      selfHeal: true

 

✅ 설명:

• source.path → Kustomize 오버레이가 적용된 Helm 차트의 위치
• helm.valueFiles → Helm의 패키징 기능을 유지하면서 Kustomize로 추가적인 변경 적용

✅ 배포 동기화 실행:

argocd app sync example-app

---

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

🟢 Helm은 패키징된 형태로 Kubernetes 애플리케이션을 관리할 때 유용하며, 환경별 설정을 Values 파일로 적용할 수 있음
🟢 Kustomize는 기존 YAML 매니페스트를 유지하면서 환경별로 필요한 설정만 Patch 방식으로 변경할 때 적합함
🟢 Argo CD는 Helm과 Kustomize를 모두 지원하며, GitOps 방식을 활용하여 자동으로 애플리케이션을 배포 가능
🟢 Helm과 Kustomize를 함께 사용하면 Helm의 패키징 기능과 Kustomize의 환경별 설정 기능을 동시에 활용 가능