Working with Helm: basics

🧭 Helm CLI 주요 명령어 요약

1️⃣ 도움말 확인

helm help
helm <subcommand> help

• Helm CLI에서 할 수 있는 명령어 목록과 각 명령의 옵션 확인
• 예: helm repo help, helm install --help, helm rollback --help

---

2️⃣ Chart 검색

✅ Artifact Hub에서 검색 (공식 웹)

• 웹사이트: https://artifacthub.io
• 공식/검증 배지 있는 chart 사용 권장
• Chart 설명, 버전, 설정 예시 등을 웹에서 확인 가능

✅ CLI에서 검색

helm search hub wordpress         # Artifact Hub에서 검색
helm search repo wordpress        # 등록된 로컬 repo에서 검색

• hub: Artifact Hub에 등록된 chart 검색
• repo: helm repo add로 등록한 repo 내에서 검색

---

3️⃣ Helm 저장소 추가 & 업데이트

helm repo add bitnami https://charts.bitnami.com/bitnami
helm repo update
helm repo list

• add: chart를 가져올 저장소를 등록
• update: 최신 chart 정보 갱신 (apt update와 유사)
• list: 현재 등록된 저장소 목록 확인

---

4️⃣ Chart 설치

helm install my-site bitnami/wordpress

• my-site: 릴리스 이름 (각 앱 인스턴스의 ID 개념)
• bitnami/wordpress: 저장소와 chart 이름

---

5️⃣ 릴리스 확인, 삭제

helm list                        # 현재 설치된 릴리스 목록
helm uninstall my-site          # 릴리스 삭제 (모든 관련 리소스 자동 제거)

• helm uninstall은 배포한 모든 K8s 오브젝트도 제거됨
• 실무에서는 --namespace 옵션을 자주 함께 사용함

---

💡 설치 후 출력 예시

Helm chart 중 일부는 설치가 끝나면 사용법, URL, 기본 비밀번호 등을 출력해줌 (템플릿 내 NOTES.txt 파일의 역할)

helm install my-site bitnami/wordpress
# 설치 후 출력 예시
...
NOTES:
1. Get the WordPress URL:
   echo "http://$(minikube ip):$(kubectl get svc --namespace default my-site -o jsonpath='{.spec.ports[0].nodePort}')"
...

---

🗂️ 실전 흐름 요약

1. Artifact Hub나 CLI에서 chart 검색
2. helm repo add로 chart 저장소 등록
3. helm install로 chart 설치 → release 생성됨
4. helm list로 현재 릴리스 상태 확인
5. helm upgrade, helm rollback, helm uninstall 등으로 앱 유지보수

---

✅ 적용 팁

상황	명령어
chart 저장소 최신 정보 받아오기	helm repo update
특정 chart의 기본값 확인	helm show values bitnami/wordpress
설치 시 설정값 커스터마이징	helm install -f my-values.yaml
릴리스 변경 이력 보기	helm history <release>
릴리스 롤백	helm rollback <release> <revision>

---