# Chart.yaml
apiVersion: v2          # Helm v3는 반드시 v2
name: my-webapp
description: A production-ready web application chart
type: application       # application | library
version: 0.1.0          # Chart 버전 (SemVer)
appVersion: "1.0.0"     # 실제 앱 버전 (참조용, 이미지 태그와는 별도)

# 외부 Chart 의존성 (서브차트)
dependencies:
  - name: redis
    version: "18.x.x"
    repository: "https://charts.bitnami.com/bitnami"
    condition: redis.enabled   # values.yaml의 값으로 선택적 설치

# values.yaml
replicaCount: 1

image:
  repository: nginx
  tag: "1.25"
  pullPolicy: IfNotPresent

service:
  type: ClusterIP
  port: 80
  targetPort: 8080

ingress:
  enabled: false
  host: ""
  annotations: {}

resources:
  requests:
    cpu: 100m
    memory: 128Mi
  limits:
    cpu: 500m
    memory: 512Mi

env: []
#  - name: DATABASE_URL
#    valueFrom:
#      secretKeyRef:
#        name: db-secret
#        key: url

redis:
  enabled: false      # 서브차트 활성화 여부
  auth:
    enabled: false

# templates/deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: {{ include "my-webapp.fullname" . }}
  labels:
    {{- include "my-webapp.labels" . | nindent 4 }}
spec:
  replicas: {{ .Values.replicaCount }}
  selector:
    matchLabels:
      {{- include "my-webapp.selectorLabels" . | nindent 6 }}
  template:
    metadata:
      labels:
        {{- include "my-webapp.selectorLabels" . | nindent 8 }}
    spec:
      containers:
        - name: {{ .Chart.Name }}
          image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
          imagePullPolicy: {{ .Values.image.pullPolicy }}
          ports:
            - containerPort: {{ .Values.service.targetPort }}
          {{- if .Values.env }}
          env:
            {{- toYaml .Values.env | nindent 12 }}
          {{- end }}
          resources:
            {{- toYaml .Values.resources | nindent 12 }}

helm install my-app ./chart -f prod.yaml --set image.tag=v2
   │
   ① 차트 로드 — Chart.yaml · values.yaml · templates/ · charts/(서브차트) 읽기
   │
   ② 값 병합 — values.yaml(기본) < -f prod.yaml(파일) < --set(CLI) 순으로 덮어씀
   │      → 최종 .Values 객체 확정
   │
   ③ 템플릿 실행 — templates/의 {{ ... }} 를 .Values로 치환
   │      (include·toYaml·required·default 함수, if 조건, range 반복)
   │
   ④ YAML 산출 — 렌더된 텍스트를 K8s 매니페스트로 파싱
   │
   ⑤ 검증·전송 — lint/스키마 확인 후 API server로 apply
   │      (helm template은 ④까지만 하고 여기서 멈춰 텍스트만 출력)
   ▼
[결과]  최종 Deployment · Service · ConfigMap 매니페스트

# template 함수는 pipeline에 연결할 수 없어서 indent가 안 됩니다.
# include를 사용하면 결과를 pipeline으로 넘길 수 있습니다.

# 잘못된 방법 (indent 불가)
{{template "my-webapp.labels" .}}

# 올바른 방법 (nindent로 들여쓰기 적용)
{{- include "my-webapp.labels" . | nindent 4 }}

# 예: 여러 manifest에서 동일한 label 블록 재사용
metadata:
  labels:
    {{- include "my-webapp.labels" . | nindent 4 }}
spec:
  selector:
    matchLabels:
      {{- include "my-webapp.selectorLabels" . | nindent 6 }}

# values.yaml에 정의한 구조체를 그대로 YAML로 출력
resources:
  {{- toYaml .Values.resources | nindent 2 }}

# 결과:
# resources:
#   requests:
#     cpu: 100m
#     memory: 128Mi
#   limits:
#     cpu: 500m
#     memory: 512Mi

# env 배열 처리 (아이템이 있을 때만 출력)
{{- if .Values.env }}
env:
  {{- toYaml .Values.env | nindent 2 }}
{{- end }}

# annotations 맵 처리
{{- with .Values.ingress.annotations }}
annotations:
  {{- toYaml . | nindent 4 }}
{{- end }}

# 값이 비어 있으면 오류 메시지와 함께 렌더링 중단
image:
  repository: {{ required "image.repository는 필수 값입니다" .Values.image.repository }}
  tag: {{ required "image.tag는 필수 값입니다" .Values.image.tag | quote }}

# Ingress host 검증
{{- if .Values.ingress.enabled }}
  {{- $host := required "ingress.enabled가 true이면 ingress.host를 지정해야 합니다" .Values.ingress.host }}
  rules:
    - host: {{ $host }}
{{- end }}

# .Values에 값이 없거나 비어 있을 때 기본값 사용
replicas: {{ .Values.replicaCount | default 1 }}
pullPolicy: {{ .Values.image.pullPolicy | default "IfNotPresent" }}

# 조건부 기본값 (string 빈 값 처리)
{{- $name := .Values.nameOverride | default .Chart.Name }}
name: {{ $name | trunc 63 | trimSuffix "-" }}

# indent: 지정한 수만큼 공백 추가 (앞에 줄바꿈 없음)
# nindent: newline + indent (앞에 줄바꿈 포함) ← 주로 이것을 사용

# indent 사용 시 (줄바꿈을 직접 관리해야 함)
labels:
{{ include "my-webapp.labels" . | indent 4 }}

# nindent 사용 시 (더 깔끔함, - 로 앞 공백 제거)
labels:
  {{- include "my-webapp.labels" . | nindent 2 }}

{{/*
  Expand the name of the chart.
*/}}
{{- define "my-webapp.name" -}}
{{- .Values.nameOverride | default .Chart.Name | trunc 63 | trimSuffix "-" }}
{{- end }}

{{/*
  Create a default fully qualified app name.
  Release 이름이 Chart 이름을 포함하면 중복 제거
*/}}
{{- define "my-webapp.fullname" -}}
{{- if .Values.fullnameOverride }}
{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" }}
{{- else }}
{{- $name := .Values.nameOverride | default .Chart.Name }}
{{- if contains $name .Release.Name }}
{{- .Release.Name | trunc 63 | trimSuffix "-" }}
{{- else }}
{{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" }}
{{- end }}
{{- end }}
{{- end }}

{{/*
  공통 label — 모든 리소스에 붙는 표준 label
*/}}
{{- define "my-webapp.labels" -}}
helm.sh/chart: {{ include "my-webapp.chart" . }}
{{ include "my-webapp.selectorLabels" . }}
app.kubernetes.io/managed-by: {{ .Release.Service }}
{{- if .Chart.AppVersion }}
app.kubernetes.io/version: {{ .Chart.AppVersion | quote }}
{{- end }}
{{- end }}

{{/*
  Selector label — Deployment의 selector.matchLabels에 사용
  (한 번 배포 후 변경하면 안 됨!)
*/}}
{{- define "my-webapp.selectorLabels" -}}
app.kubernetes.io/name: {{ include "my-webapp.name" . }}
app.kubernetes.io/instance: {{ .Release.Name }}
{{- end }}

{{/*
  Chart 이름+버전 문자열
*/}}
{{- define "my-webapp.chart" -}}
{{- printf "%s-%s" .Chart.Name .Chart.Version | replace "+" "_" | trunc 63 | trimSuffix "-" }}
{{- end }}

# . (현재 컨텍스트 전체)를 전달하는 것이 일반적
{{- include "my-webapp.labels" . | nindent 4 }}

# 특정 값만 전달할 때 (dict 사용)
{{- include "my-webapp.serviceAccountName" (dict "Values" .Values "Release" .Release) }}

# range 블록 내부에서 루트 컨텍스트 전달 ($ 사용)
{{- range .Values.ingress.hosts }}
- host: {{ .host }}
  paths:
  {{- range .paths }}
    - path: {{ .path }}
      # range 블록 내부에서 .Values는 현재 스코프(path 객체)를 가리킴
      # $.Values로 루트 컨텍스트의 Values에 접근
      pathType: {{ $.Values.ingress.pathType | default "Prefix" }}
  {{- end }}
{{- end }}

# 1단계: Chart.yaml에 dependency 추가 (이미 앞에서 작성함)
# dependencies:
#   - name: redis
#     version: "18.x.x"
#     repository: "https://charts.bitnami.com/bitnami"
#     condition: redis.enabled

# 2단계: repository 추가 및 dependency 다운로드
helm repo add bitnami https://charts.bitnami.com/bitnami
helm repo update
helm dependency update ./my-webapp

# 결과: charts/ 디렉토리에 redis-18.x.x.tgz 생성
ls ./my-webapp/charts/
# redis-18.6.1.tgz

# 3단계: 서브차트 values 오버라이드 (values.yaml에서)
# 서브차트 이름(redis)을 키로 사용하여 values 전달

# values.yaml — 서브차트 설정은 서브차트 이름 아래에 작성
redis:
  enabled: true               # condition 값 (이 키로 서브차트 활성화 제어)
  auth:
    enabled: true
    password: ""  # 값은 Secret 참조 또는 별도 보호된 values 파일로 주입
  master:
    persistence:
      size: 5Gi
  replica:
    replicaCount: 1

# templates/deployment.yaml — Redis 서비스에 연결하는 환경변수
env:
  {{- if .Values.redis.enabled }}
  - name: REDIS_HOST
    # 서브차트 Service 이름은 "<release-name>-redis-master" 형식
    value: "{{ .Release.Name }}-redis-master"
  - name: REDIS_PORT
    value: "6379"
  {{- end }}

# Redis 포함하여 설치
helm install my-webapp ./my-webapp \
  --namespace helm-dev \
  --set redis.enabled=true \
  --set-file redis.auth.password=/run/secrets/redis-password

# 렌더링 결과 확인 (클러스터 불필요)
helm template my-webapp ./my-webapp \
  --set redis.enabled=true \
  --namespace helm-dev | less

# Redis 없이 설치 (로컬 개발)
helm install my-webapp-dev ./my-webapp \
  --namespace helm-dev \
  --set redis.enabled=false