[Ep.10] [Argo CD 운영 #5] Argo CD에서 Helm과 Kustomize를 활용한 배포 전략

🔹 Helm과 Kustomize란?

Kubernetes에서 애플리케이션을 배포할 때, YAML 매니페스트를 효율적으로 관리하고 재사용할 수 있는 두 가지 주요 방법이 있습니다.

1️⃣ Helm → 패키지 관리 방식으로, 애플리케이션을 템플릿화하여 배포
2️⃣ Kustomize → 기존 YAML을 수정하여 오버레이 방식으로 배포

 

Argo CD는 Helm과 Kustomize를 모두 지원하며, 이를 활용하면 GitOps 방식의 배포를 더욱 유연하게 관리할 수 있습니다.

---

🔹 Helm을 활용한 Argo CD 배포 전략

✅ 1. Helm이란?

Helm은 Kubernetes 애플리케이션을 패키징하고 배포할 수 있도록 도와주는 도구입니다.
Helm 차트(Chart)를 사용하면, YAML 매니페스트를 템플릿화하여 재사용성을 높이고 유지보수를 간편하게 수행할 수 있습니다.

 

Helm의 주요 구성 요소:

• Chart → Kubernetes 리소스를 정의하는 패키지
• Values.yaml → 사용자 정의 값을 설정하는 파일
• Templates/ → 템플릿 파일이 위치한 디렉터리

---

✅ 2. Argo CD에서 Helm 애플리케이션 정의하기

Argo CD는 Helm을 지원하므로, Application CRD에서 Helm 설정을 추가하면 자동으로 차트를 배포할 수 있습니다.

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: example-helm-app
  namespace: argocd
spec:
  project: default
  source:
    repoURL: https://github.com/example/repo.git  # Helm 차트가 저장된 Git 저장소
    targetRevision: main  # 사용할 브랜치 또는 태그
    path: charts/example  # Helm 차트의 위치
    helm:
      valueFiles:
        - values.yaml  # 기본 values 파일
        - values-production.yaml  # 추가적인 환경별 설정
  destination:
    server: https://kubernetes.default.svc
    namespace: example-namespace
  syncPolicy:
    automated:
      prune: true
      selfHeal: true

 

✅ 설명:

• repoURL → Helm 차트가 저장된 Git 저장소
• path → Helm 차트가 위치한 경로
• helm.valueFiles → 여러 개의 values 파일을 적용 가능
• syncPolicy → 자동 동기화 및 Self-Healing 설정

---

✅ 3. Helm 차트를 직접 사용하여 Argo CD에 배포하기

Argo CD CLI를 사용하여 Helm 차트를 배포할 수도 있습니다.

argocd app create example-helm-app \
  --repo https://github.com/example/repo.git \
  --path charts/example \
  --dest-server https://kubernetes.default.svc \
  --dest-namespace example-namespace \
  --helm-set replicaCount=3

---

🔹 Kustomize를 활용한 Argo CD 배포 전략

✅ 1. Kustomize란?

Kustomize는 기존의 Kubernetes YAML 파일을 수정하여 환경별 배포를 쉽게 관리할 수 있도록 돕는 도구입니다.

Kustomize를 사용하면 별도의 템플릿 없이 기존 YAML을 오버레이(Overlay) 방식으로 변경할 수 있습니다.

Kustomize의 주요 구성 요소:

• base/ → 기본 YAML 매니페스트
• overlays/ → 특정 환경에 맞는 커스텀 설정

---

✅ 2. Argo CD에서 Kustomize 애플리케이션 정의하기

Argo CD는 Kustomize를 기본적으로 지원하므로, Application 리소스에서 Kustomize 설정을 추가하면 자동으로 적용됩니다.

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: example-kustomize-app
  namespace: argocd
spec:
  project: default
  source:
    repoURL: https://github.com/example/repo.git  # Kustomize 파일이 위치한 Git 저장소
    targetRevision: main
    path: overlays/production  # 사용할 Kustomize 오버레이 디렉터리
    kustomize:
      namePrefix: prod-  # 애플리케이션 이름에 'prod-' 접두어 추가
  destination:
    server: https://kubernetes.default.svc
    namespace: example-namespace
  syncPolicy:
    automated:
      prune: true
      selfHeal: true

 

✅ 설명:

• repoURL → Kustomize 파일이 저장된 Git 저장소
• path → Kustomize 매니페스트가 위치한 디렉터리
• kustomize.namePrefix → 애플리케이션 이름에 접두어 추가

---

✅ 3. Kustomize의 오버레이 구조 예제

1️⃣ base/kustomization.yaml (기본 설정)

resources:
  - deployment.yaml
  - service.yaml

2️⃣ overlays/production/kustomization.yaml (프로덕션 환경 설정)

bases:
  - ../../base
patchesStrategicMerge:
  - production-deployment.yaml

3️⃣ overlays/production/production-deployment.yaml (배포 설정 변경)

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-app
spec:
  replicas: 5  # 기본 설정에서 프로덕션 환경에서는 5개로 변경

---

✅ 4. Kustomize를 이용한 애플리케이션 동기화

Argo CD CLI를 사용하여 Kustomize 애플리케이션을 수동으로 동기화할 수 있습니다.

argocd app sync example-kustomize-app

---

🔹 Helm vs Kustomize: 어떤 것을 선택할까?

비교 항목	Helm	Kustomize
사용 방식	템플릿 기반 패키징	YAML 오버레이 방식
변수 관리	values.yaml 파일 사용	패치 파일을 사용
환경별 배포	values.production.yaml 등 사용	overlays/production 디렉터리 사용
유연성	높은 유연성 (템플릿화 가능)	단순한 구조, 별도 템플릿 없음
Argo CD 지원	기본 지원 (helm: 설정)	기본 지원 (kustomize: 설정)

 

✅ Helm이 적합한 경우

• 배포가 복잡하고, 패키징된 형태로 관리해야 할 때
• 다수의 값(values.yaml)을 쉽게 변경해야 할 때

✅ Kustomize가 적합한 경우

• 기존 YAML을 유지하면서 환경별 차이만 적용해야 할 때
• 템플릿 없이 간단한 변경을 적용하고 싶을 때

---

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

🟢 Argo CD는 Helm과 Kustomize를 모두 지원하며, GitOps 기반 배포를 자동화할 수 있음
🟢 Helm은 템플릿 기반 패키징 방식으로, values.yaml을 활용하여 유연한 배포 가능
🟢 Kustomize는 기존 YAML을 유지한 채 오버레이 방식으로 환경별 배포 관리 가능
🟢 Helm과 Kustomize 중 사용 목적에 따라 적절한 방식을 선택하여 GitOps 배포 전략을 최적화 가능