📦 쿠버네티스 앱 설치, 이제 apt처럼 쉽게 – Helm 기초 완전 정복

쿠버네티스에 애플리케이션을 배포하려면 Deployment, Service, ConfigMap, PVC 등 여러 YAML 파일을 각각 apply해야 합니다. MySQL 하나 올리는 데 파일이 5개, 10개가 넘기도 합니다. Helm은 이 모든 것을 하나의 패키지(Chart)로 묶어서, helm install 명령어 하나로 배포하고, 업그레이드하고, 롤백할 수 있게 해줍니다. 리눅스의 apt, brew 같은 패키지 매니저를 쿠버네티스에 얹은 것이라고 생각하면 됩니다.

---

🧩 Helm의 핵심 개념 3가지

Repository (앱스토어)  →  Chart (앱)  →  Release (설치된 앱)
bitnami 저장소         →  nginx Chart →  my-nginx (내 클러스터에 설치됨)

• Repository: Chart들이 모여 있는 저장소 (npm registry, PyPI 같은 것)
• Chart: 쿠버네티스 리소스 일체를 담은 패키지
• Release: Chart를 클러스터에 설치한 결과물. 이름을 직접 붙입니다 (my-nginx, prod-mysql 등)

---

🚀 실습 Step 1 — 저장소 등록 및 설치

# Bitnami 저장소 추가
helm repo add bitnami https://charts.bitnami.com/bitnami
helm repo update

# 사용 가능한 nginx chart 검색
helm search repo nginx

설치 가능한 bitnami/nginx 목록이 보이면 준비 완료입니다.

# 설치! (my-nginx는 내가 붙인 이름, 언제든 바꿀 수 있음)
helm install my-nginx bitnami/nginx

# Helm이 관리하는 Release 목록 확인
helm list

# 실제 파드가 떴는지 확인
kubectl get pod,svc

---

⚙️ 실습 Step 2 — 설정 변경 (Upgrade)

Helm의 강력함은 설정 파일을 오버라이드해서 원하는 대로 커스터마이징할 수 있다는 겁니다.

# my-values.yaml
replicaCount: 2          # 기본값 1개 → 2개로

service:
  type: NodePort         # 기본값 LoadBalancer → NodePort로

resources:
  limits:
    cpu: 100m
    memory: 128Mi

# 이미 설치된 Release를 지우지 않고 설정만 업그레이드
helm upgrade my-nginx bitnami/nginx -f my-values.yaml

# 파드가 2개로 늘어나고 서비스 타입이 바뀌었는지 확인
kubectl get pod,svc

업그레이드 후에도 기존 파드를 한 번에 내리지 않고 Rolling Update 방식으로 전환합니다. 서비스는 끊기지 않습니다.

---

⏪ 실습 Step 3 — 롤백

배포에 문제가 생겼다면? Helm은 각 배포 시점을 Revision으로 저장해두기 때문에 원하는 시점으로 되돌릴 수 있습니다.

# 배포 이력 확인
helm history my-nginx

# REVISION  STATUS      CHART           DESCRIPTION
# 1         superseded  nginx-15.x.x    Install complete
# 2         deployed    nginx-15.x.x    Upgrade complete

# Revision 1 (처음 설치 상태)로 롤백
helm rollback my-nginx 1

# 파드가 다시 1개로 줄었는지 확인
kubectl get pods

# 히스토리 다시 확인 → Revision 3이 새로 생김
helm history my-nginx

롤백 후 히스토리를 보면 Revision 3이 새로 생깁니다. Revision 1이 사라진 이유? 쿠버네티스 롤백과 마찬가지로, Revision 1의 설정을 현재 적용한 새 Revision 3이 생성됩니다. 이게 “선언적 상태 관리”의 본질입니다.

---

🗑️ 삭제

# Release 및 관련 리소스 전체 삭제
helm uninstall my-nginx

# 파일 정리
rm my-values.yaml

---

📋 Helm 핵심 명령어 치트시트

구분	명령어	설명
저장소	helm repo add [이름] [URL]	차트 저장소 추가
	helm repo update	저장소 목록 최신화
	helm search repo [키워드]	차트 검색
설치/관리	helm install [릴리즈] [차트]	설치
	helm list	설치된 Release 목록
	helm status [릴리즈]	Release 상태 확인
변경	helm upgrade [릴리즈] [차트] -f [파일]	설정 업그레이드
복구	helm history [릴리즈]	배포 이력 확인
	helm rollback [릴리즈] [번호]	특정 Revision으로 롤백
삭제	helm uninstall [릴리즈]	Release 전체 삭제

---

💡 Helm이 없으면 어떻게 됐을까?

Nginx 하나만 해도 helm install이지만, 수동으로 하면:

1. Deployment YAML 작성
2. Service YAML 작성
3. ConfigMap YAML 작성 (설정 있는 경우)
4. RBAC YAML 작성 (권한 필요시)
5. 각각 kubectl apply

버전 업그레이드는? 다시 YAML 고치고 apply. 롤백은? 이전 YAML 찾아서 다시 apply… Helm은 이 반복 작업을 자동화해줍니다.

다음 글에서는 Helm을 “쓰는 사람”에서 “만드는 사람”으로 — Custom Helm Chart를 직접 제작하는 과정을 다룹니다.