Helm Basics

# 동일 Chart로 여러 Release 생성 가능
helm install prod-wordpress bitnami/wordpress
helm install dev-wordpress bitnami/wordpress

# 각 Release는 독립적으로 관리
# 각 Release는 자체 Revision 이력 보유

# 공식 스크립트로 설치
curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash

# macOS (Homebrew)
brew install helm

# Ubuntu/Debian
curl https://baltocdn.com/helm/signing.asc | gpg --dearmor | sudo tee /usr/share/keyrings/helm.gpg > /dev/null
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/helm.gpg] https://baltocdn.com/helm/stable/debian/ all main" | sudo tee /etc/apt/sources.list.d/helm-stable-debian.list
sudo apt-get update
sudo apt-get install helm

# CentOS/RHEL
sudo dnf install helm

# Windows (Chocolatey)
choco install kubernetes-helm

helm version

# 출력 예시
# version.BuildInfo{Version:"v3.14.0", GitCommit:"...", ...}

apiVersion: v2                    # Helm 3용 (필수)
name: my-app                      # Chart 이름 (필수)
version: 1.0.0                    # Chart 버전 (필수)
appVersion: "2.0.0"               # 애플리케이션 버전
description: My application chart
type: application                 # application 또는 library
keywords:
  - web
  - nginx
maintainers:
  - name: John Doe
    email: john@example.com
home: https://example.com
icon: https://example.com/icon.png
dependencies:                     # 의존 Chart
  - name: redis
    version: "17.x.x"
    repository: https://charts.bitnami.com/bitnami
    condition: redis.enabled

# templates/deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: {{ .Release.Name }}-{{ .Chart.Name }}
  labels:
    app: {{ .Chart.Name }}
    release: {{ .Release.Name }}
spec:
  replicas: {{ .Values.replicaCount }}
  selector:
    matchLabels:
      app: {{ .Chart.Name }}
  template:
    metadata:
      labels:
        app: {{ .Chart.Name }}
    spec:
      containers:
      - name: {{ .Chart.Name }}
        image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
        ports:
        - containerPort: {{ .Values.service.port }}

# values.yaml
replicaCount: 3
image:
  repository: nginx
  tag: "1.21"
service:
  port: 80

# 조건문 (if)
{{- if .Values.ingress.enabled }}
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: {{ .Release.Name }}-ingress
spec:
  rules:
  - host: {{ .Values.ingress.host }}
{{- end }}

# 반복문 (range)
{{- range .Values.env }}
- name: {{ .name }}
  value: {{ .value | quote }}
{{- end }}

# 기본값 (default)
replicas: {{ .Values.replicaCount | default 1 }}

# 필수값 (required)
image: {{ required "image.repository is required" .Values.image.repository }}

# 문자열 함수
name: {{ .Values.name | lower | trunc 63 }}
label: {{ .Values.label | quote }}
name: {{ .Values.name | default "myapp" }}

# 숫자 함수
port: {{ .Values.port | int }}

# 리스트/딕셔너리 함수
{{- toYaml .Values.resources | nindent 12 }}

# 인코딩
data:
  password: {{ .Values.password | b64enc }}

# templates/_helpers.tpl
{{- define "myapp.fullname" -}}
{{- printf "%s-%s" .Release.Name .Chart.Name | trunc 63 | trimSuffix "-" }}
{{- end }}

{{- define "myapp.labels" -}}
app.kubernetes.io/name: {{ .Chart.Name }}
app.kubernetes.io/instance: {{ .Release.Name }}
app.kubernetes.io/version: {{ .Chart.AppVersion }}
{{- end }}

# 사용
metadata:
  name: {{ include "myapp.fullname" . }}
  labels:
    {{- include "myapp.labels" . | nindent 4 }}

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

# 저장소 목록
helm repo list

# 저장소 업데이트 (중요!)
helm repo update

# 저장소 제거
helm repo remove bitnami

# Artifact Hub 검색 (전체)
helm search hub wordpress

# 로컬 저장소 검색
helm search repo wordpress

# 모든 버전 표시
helm search repo wordpress --versions

# Chart 정보
helm show chart bitnami/wordpress

# values.yaml 확인
helm show values bitnami/wordpress

# 전체 정보 (README 포함)
helm show all bitnami/wordpress

# 기본 설치
helm install my-release bitnami/wordpress

# 네임스페이스 지정
helm install my-release bitnami/wordpress -n production

# 네임스페이스 생성과 함께 설치
helm install my-release bitnami/wordpress -n production --create-namespace

# 특정 버전 설치
helm install my-release bitnami/wordpress --version 15.0.0

# 삭제
helm uninstall my-release

# 네임스페이스와 함께 삭제
helm uninstall my-release -n production

# Release 목록
helm list
helm list -A  # 모든 네임스페이스
helm list -a  # 삭제 예정 포함

# Release 상태
helm status my-release

# Release 이력
helm history my-release

# 단일 값
--set replicaCount=3

# 중첩 값
--set image.repository=nginx
--set image.tag=1.21

# 배열
--set env[0].name=FOO,env[0].value=bar

# 문자열 (특수문자 포함)
--set password="my\,password"

# 여러 값
--set replicaCount=3,image.tag=1.21

# custom-values.yaml
replicaCount: 3

image:
  repository: nginx
  tag: "1.21"
  pullPolicy: Always

service:
  type: LoadBalancer
  port: 80

resources:
  limits:
    cpu: 500m
    memory: 512Mi
  requests:
    cpu: 250m
    memory: 256Mi

# 여러 파일 지정 (나중 파일이 우선)
helm install my-release bitnami/nginx \
  --values values-default.yaml \
  --values values-production.yaml

# 압축 파일로 다운로드
helm pull bitnami/wordpress

# 압축 해제하여 다운로드
helm pull bitnami/wordpress --untar

# 로컬 Chart로 설치
helm install my-wp ./wordpress

# 기본 업그레이드 (최신 Chart)
helm upgrade my-release bitnami/nginx

# 특정 버전으로 업그레이드
helm upgrade my-release bitnami/nginx --version 15.0.0

# 값 변경과 함께 업그레이드
helm upgrade my-release bitnami/nginx --set replicaCount=5

# 값 파일로 업그레이드
helm upgrade my-release bitnami/nginx -f new-values.yaml

# 설치 또는 업그레이드 (없으면 설치)
helm upgrade --install my-release bitnami/nginx

# 이전 Revision으로 롤백
helm rollback my-release

# 특정 Revision으로 롤백
helm rollback my-release 2

# Dry-run으로 확인
helm rollback my-release 2 --dry-run

helm history my-release

# 출력 예시
REVISION  UPDATED                   STATUS      CHART         APP VERSION  DESCRIPTION
1         Mon Jan 15 10:00:00 2024  superseded  nginx-15.0.0  1.23.0       Install complete
2         Mon Jan 15 11:00:00 2024  superseded  nginx-15.1.0  1.24.0       Upgrade complete
3         Mon Jan 15 12:00:00 2024  deployed    nginx-15.0.0  1.23.0       Rollback to 1

# 템플릿 렌더링 결과 출력 (설치 없이)
helm template my-release bitnami/nginx

# 특정 values로 렌더링
helm template my-release bitnami/nginx -f values.yaml

# 특정 템플릿만 렌더링
helm template my-release bitnami/nginx -s templates/deployment.yaml

# 설치 시뮬레이션
helm install my-release bitnami/nginx --dry-run

# 상세 출력
helm install my-release bitnami/nginx --dry-run --debug

# 업그레이드 시뮬레이션
helm upgrade my-release bitnami/nginx --dry-run

# Chart 문법 검사
helm lint ./my-chart

# 출력 예시
==> Linting ./my-chart
[INFO] Chart.yaml: icon is recommended
[WARNING] templates/deployment.yaml: object name does not conform to Kubernetes naming requirements

1 chart(s) linted, 0 chart(s) failed

# 배포된 매니페스트 확인
helm get manifest my-release

# 사용된 values 확인
helm get values my-release

# 모든 정보
helm get all my-release

# 릴리스 노트 확인
helm get notes my-release

# 기본 Chart 스캐폴딩
helm create my-app

# 생성된 구조
my-app/
├── Chart.yaml
├── values.yaml
├── charts/
├── templates/
│   ├── deployment.yaml
│   ├── service.yaml
│   ├── ingress.yaml
│   ├── hpa.yaml
│   ├── serviceaccount.yaml
│   ├── _helpers.tpl
│   ├── NOTES.txt
│   └── tests/
│       └── test-connection.yaml
└── .helmignore

# Chart 패키징 (.tgz 생성)
helm package ./my-app

# 버전 지정
helm package ./my-app --version 1.0.0

# 출력 디렉토리 지정
helm package ./my-app -d ./charts

# 의존성 다운로드
helm dependency update ./my-app

# 의존성 목록
helm dependency list ./my-app

# charts/ 폴더에 의존 Chart 다운로드됨

# 웹에서 검색: https://artifacthub.io

# CLI에서 검색
helm search hub wordpress

# 공식/검증된 Chart 확인
# - Official: Kubernetes 프로젝트 공식
# - Verified Publisher: 검증된 게시자

# 1. Repository 추가
helm repo add bitnami https://charts.bitnami.com/bitnami
helm repo update

# 2. 기본값 확인
helm show values bitnami/wordpress > wordpress-values.yaml

# 3. 커스텀 values 작성
cat <<EOF > my-wordpress-values.yaml
wordpressUsername: admin
wordpressPassword: secretpassword
wordpressBlogName: "My Tech Blog"

mariadb:
  auth:
    rootPassword: mariadb-root-password
    password: mariadb-password

service:
  type: LoadBalancer

persistence:
  enabled: true
  size: 10Gi
EOF

# 4. 설치
helm install my-blog bitnami/wordpress \
  -f my-wordpress-values.yaml \
  -n wordpress --create-namespace

# 5. 상태 확인
helm status my-blog -n wordpress
kubectl get pods -n wordpress
kubectl get svc -n wordpress

# 1. Repository 추가
helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx
helm repo update

# 2. 설치
helm install ingress-nginx ingress-nginx/ingress-nginx \
  --namespace ingress-nginx \
  --create-namespace \
  --set controller.replicaCount=2

# 3. 확인
kubectl get pods -n ingress-nginx
kubectl get svc -n ingress-nginx

# Repository
helm repo add <name> <url>
helm repo list
helm repo update
helm repo remove <name>

# 검색
helm search hub <keyword>
helm search repo <keyword>

# Chart 정보
helm show chart <chart>
helm show values <chart>
helm show all <chart>

# 설치/삭제
helm install <release> <chart> [--values <file>] [--set key=value]
helm uninstall <release>

# 업그레이드/롤백
helm upgrade <release> <chart>
helm upgrade --install <release> <chart>
helm rollback <release> [revision]

# 조회
helm list [-A]
helm status <release>
helm history <release>
helm get values <release>
helm get manifest <release>

# 디버깅
helm template <release> <chart>
helm install <release> <chart> --dry-run --debug
helm lint <chart-path>

# Chart 생성
helm create <name>
helm package <chart-path>
helm dependency update <chart-path>

# 다운로드
helm pull <chart>
helm pull <chart> --untar