[Kubernetes] 복잡한 매니페스트를 차트(Chart) 단위로 원클릭 배포하기

Repository (저장소)   →   Chart (패키지)   →   Release (설치된 인스턴스)
bitnami               →   bitnami/redis    →   my-redis (helm install로 생성)
                                           →   my-redis2 (같은 Chart, 다른 이름)

Release의 변경 이력 = Revision
  Revision 1: helm install
  Revision 2: helm upgrade (이미지 업데이트)
  Revision 3: helm rollback 1 (Revision 1로 되돌림)

# 저장소 추가 및 검색
helm repo add bitnami https://charts.bitnami.com/bitnami
helm repo add stable https://charts.helm.sh/stable
helm repo update

# Chart 검색
helm search repo redis
# NAME                    CHART VERSION   APP VERSION   DESCRIPTION
# bitnami/redis           18.19.4         7.2.5         Redis® is an open source, advanced key-value ...
# bitnami/redis-cluster   9.6.7           7.2.5         Redis® is an open source...

# ArtifactHub 검색 (웹 UI)
helm search hub prometheus

[사용자]  helm install my-redis bitnami/redis -f values-dev.yaml
   │
   ① 차트 로드: Chart.yaml·templates/·values.yaml을 읽고 charts/ 의존 차트 해석
   │
   ② values 병합: 차트 기본 values.yaml ← -f 파일 ← --set  (뒤일수록 우선)
   │
   ③ 템플릿 렌더링: templates/*.yaml의 .Values·.Release·.Chart 참조를 병합값으로 치환 (Go template)
   │
   ④ 매니페스트 생성: 렌더 결과를 완성된 K8s YAML 묶음으로 산출
   │    (helm template로 배포 전 미리 확인 가능)
   │
   ⑤ API server에 apply: Deployment·Service·Secret·ConfigMap을 클러스터에 생성
   │
   ⑥ 릴리스 이력 저장: 이 리비전 스냅샷을 Secret(sh.helm.release.v1.<릴리스>.v<N>)에 기록
   ▼
[클러스터]  릴리스 my-redis  (REVISION 1, STATUS deployed)

# 기본값으로 설치
helm install my-redis bitnami/redis -n helm-demo

# --set으로 개별 값 오버라이드
helm install my-redis bitnami/redis \
  -n helm-demo \
  --set auth.enabled=false \
  --set replica.replicaCount=1 \
  --set architecture=standalone

# Chart의 기본 values.yaml 확인 (어떤 값을 바꿀 수 있는지)
helm show values bitnami/redis | head -50

# 커스텀 values 파일 생성 (권장: 환경별 파일 관리)
cat > redis-values-dev.yaml << 'EOF'
architecture: standalone
auth:
  enabled: false
replica:
  replicaCount: 0
master:
  resources:
    requests:
      cpu: 100m
      memory: 128Mi
    limits:
      cpu: 500m
      memory: 256Mi
  persistence:
    enabled: false   # 개발환경: PVC 없이
EOF

helm install my-redis bitnami/redis \
  -n helm-demo \
  -f redis-values-dev.yaml

# 설치된 릴리스 목록
helm list -n helm-demo
# NAME       NAMESPACE   REVISION   STATUS     CHART           APP VERSION
# my-redis   helm-demo   1          deployed   redis-18.19.4   7.2.5

# 생성된 리소스 확인
helm status my-redis -n helm-demo
kubectl get all -n helm-demo

# 업그레이드 (값 변경)
helm upgrade my-redis bitnami/redis \
  -n helm-demo \
  -f redis-values-dev.yaml \
  --set master.resources.limits.memory=512Mi

# 릴리스 이력 확인
helm history my-redis -n helm-demo
# REVISION   STATUS     CHART           DESCRIPTION
# 1          superseded redis-18.19.4   Install complete
# 2          deployed   redis-18.19.4   Upgrade complete

# --install 플래그: 없으면 install, 있으면 upgrade (CI/CD 표준 패턴)
helm upgrade --install my-redis bitnami/redis \
  -n helm-demo \
  -f redis-values-dev.yaml \
  --create-namespace    # 네임스페이스 없으면 자동 생성

# 롤백
helm rollback my-redis 1 -n helm-demo  # Revision 1로 되돌림

helm history my-redis -n helm-demo
# REVISION   STATUS      CHART           DESCRIPTION
# 1          superseded  redis-18.19.4   Install complete
# 2          superseded  redis-18.19.4   Upgrade complete
# 3          deployed    redis-18.19.4   Rollback to 1  ← 롤백도 새 리비전

# 삭제
helm uninstall my-redis -n helm-demo
# (PVC는 삭제되지 않음 — 데이터 보호)

# 새 Chart 생성
helm create mychart
ls mychart/

# templates/deployment.yaml에서 values.yaml 참조하는 방식
# {{ .Values.replicaCount }}  → values.yaml의 replicaCount 값
# {{ .Release.Name }}         → 릴리스 이름
# {{ .Chart.Version }}        → Chart 버전

# 렌더링 결과 미리 확인 (실제 배포 없이)
helm template my-release mychart/ -f custom-values.yaml

# 문법 검사
helm lint mychart/

# 패키징
helm package mychart/
# mychart-0.1.0.tgz 생성