[Ep.18] [Argo CD 배포 & 자동화 #3] Argo CD에서 Helm과 Kustomize를 활용한 배포 자동화

🔹 Helm과 Kustomize란?

쿠버네티스(Kubernetes) 환경에서는 YAML 매니페스트를 사용하여 애플리케이션을 배포하지만,
복잡한 애플리케이션의 경우 환경별(개발/운영), 버전별 차이를 효율적으로 관리하기 위해

Helm과 Kustomize 같은 도구가 필요합니다.

 

✅ Helm과 Kustomize의 역할 비교

기능	Helm	Kustomize
템플릿화 지원	O (변수 사용 가능)	X
오버레이(환경별 설정 가능)	O (Values 파일 사용)	O (Patch 사용)
패키지 관리	O (Chart Repository 지원)	X
GitOps 친화적	O	O
Argo CD 연동	O	O

 

✅ 어떤 경우에 사용하면 좋을까?
✔ Helm → 여러 환경에서 재사용이 필요한 경우 (패키지 형태로 배포)
✔ Kustomize → 기본적인 YAML을 유지하면서 환경별 차이만 적용하고 싶을 때

---

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

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

✅ 1. Argo CD에서 Helm을 사용한 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:
      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.valueFiles → 여러 개의 Values 파일을 적용하여 환경별 설정 가능
• syncPolicy.automated → 자동 배포 및 Self-Healing 활성화

✅ Helm 차트 배포 확인:

argocd app get example-app

 

✅ Helm 차트 동기화 실행:

argocd app sync example-app

---

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

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

✅ 1. Argo CD에서 Kustomize를 사용한 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

---

🔹 Argo CD에서 Helm과 Kustomize를 함께 사용하는 방법

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

✅ 1. Helm과 Kustomize를 조합한 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로 추가적인 변경 적용

 

✅ Helm + Kustomize 기반 배포 확인:

argocd app get example-app

 

✅ 배포 동기화 실행:

argocd app sync example-app

---

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

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