[Kubernetes - 4단계: Helm]

이 글에서 다루는 것

Kubernetes 앱을 패키지화하여 설치·업그레이드·롤백을 관리하는 Helm의 개념과 values.yaml을 통한 커스터마이징 방법을 다룹니다.

선수지식

• Kubernetes 1단계: Deployment & Service — 기본 리소스 이해
• Kubernetes 3단계: Ingress & Nginx Controller — 서비스 라우팅 개념

이 단계에서 해결하려는 문제

Deployment, Service, ConfigMap 등 여러 YAML 파일을 개별 관리하면, 환경별 설정 변경과 버전 관리가 어렵습니다. Helm은 이 YAML들을 하나의 Chart로 패키징하고, values.yaml로 설정만 바꿔서 재배포할 수 있게 합니다. MLOps에서 MLflow, ArgoCD, Prometheus 등을 설치할 때 사실상 표준 도구입니다.

실습 코드: GitHub (Helm)

🧭 전체 흐름 요약

① Helm 설치 및 Chart 저장소 등록
② bitnami/nginx Chart 검색 → 설치
③ 기본 설치 결과 확인 (LoadBalancer → Pending)
④ values.yaml로 NodePort 설정 변경
⑤ 설정 적용하여 재설치 + 포트 접속 확인

📁 실습 디렉토리 구성

k8s-helm/
├── values-nginx.yaml   # 커스터마이징용 설정 파일
└── README.md

⚙️ [1단계] Helm 설치

curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash
helm version

📦 [2단계] Chart 저장소 등록 & 검색

helm repo add bitnami https://charts.bitnami.com/bitnami
helm repo update
helm search repo nginx

Helm Chart는 패키지화된 K8s 앱 템플릿입니다.

🚀 [3단계] Nginx 기본 설치 (LoadBalancer 방식)

helm install my-nginx bitnami/nginx
kubectl get all

# 결과 (일부)
service/my-nginx  LoadBalancer  10.103.5.39  <pending>  80:31794/TCP,443:32036/TCP

LoadBalancer는 클라우드용 방식이라 Minikube에서는 <pending> 상태로 외부 접속이 안됩니다.

🛠️ [4단계] values.yaml로 NodePort 설정 변경

values-nginx.yaml

service:
  type: NodePort
  nodePorts:
    http: 30090

재설치

helm uninstall my-nginx
helm install my-nginx bitnami/nginx -f values-nginx.yaml
kubectl get all

# 결과 (정상 동작)
service/my-nginx  NodePort  10.109.159.213  <none>  80:30090/TCP,443:32694/TCP

접속 테스트

minikube ip         # IP 확인
curl http://<minikube-ip>:30090

📌 [5단계] 주요 Helm 명령어 정리

helm upgrade my-nginx bitnami/nginx -f values-nginx.yaml

🎯 정리 요약

설계 판단 (Why This Way?)

MLOps 스택은 수십 개 리소스가 필요하여 순수 YAML 관리가 비현실적이므로 Helm Chart로 패키징하고, values.yaml 환경 분리를 통해 GitOps(ArgoCD)와 결합하여 Git 커밋만으로 배포를 제어합니다.

다음에 읽을 글

→ Kubernetes 5단계: Prometheus + Grafana 모니터링 — 클러스터 메트릭 수집과 시각화