🚀 Helm 초보를 위한 핵심 Cheat Sheet 한눈에 보기

[cloudbro-radar]

Helm은 Kubernetes용 패키지 매니저로, 차트(chart) 기반 배포·업그레이드·롤백을 일관성 있게 관리할 수 있도록 설계된 도구입니다. 이 Cheat Sheet는 Helm의 개념, 설치 방법, 핵심 명령어를 빠르게 파악할 수 있도록 구성되었습니다.

Helm은 Kubernetes 클러스터에서 애플리케이션을 패키징·배포·관리하는 도구입니다.
Chart(템플릿 그룹) → Release(배포 인스턴스) → Repository(차트 저장소) 흐름을 기반으로 설치·업그레이드·관리 기능을 제공합니다.

요약

이 글은 Helm을 처음 사용하거나 빠르게 복습하려는 엔지니어를 위한 실무 중심 Cheat Sheet입니다. Helm의 **기본 개념(Chart·Release·Repository)**부터 설치 방법, **가장 자주 쓰이는 핵심 명령어(install, upgrade, rollback, repo 관리)**까지를 한 번에 정리해,

Kubernetes 애플리케이션을 반복 가능하고 일관되게 배포·운영하기 위한 최소 지식을 빠르게 습득하는 데 목적이 있습니다.

• 대상: Helm 입문자 및 실무 복습 필요자
• 범위: 개념 → 설치 → 필수 명령어
• 목표: Helm을 “왜 쓰는지”보다 “바로 쓰기”에 초점

Helm Cheat Sheet 핵심 내용

아래는 Helm Cheat Sheet: Everything You Need to Know to Start Using Helm의 전체 핵심 내용을 구조적으로 정리한 요약입니다.

1) Helm의 정의 및 핵심 개념

• Helm이란?
  Kubernetes를 위한 패키지 매니저로, 복잡한 애플리케이션을 정의·패키지·배포·업그레이드·롤백할 수 있게 하는 도구. 서버 사이드 구성요소가 없이 CLI로 작동함.

• 핵심 구성 요소

  • Chart: Kubernetes 리소스 정의 및 템플릿 묶음.
  • Release: 차트가 클러스터에 배포된 인스턴스.
  • Repository: 차트 저장·공유 장소.
  • Values: 설치 시 사용자 설정값 적용

• 기능

  • 설치·업그레이드·롤백
  • 버전 관리 및 일관된 환경 구성
  • 의존성 정의 및 템플레이팅 적용

2) 설치 & 초기 설정

• Helm 설치 방법

  • 바이너리 직접 다운로드
  • 플랫폼 패키지 매니저 (macOS Homebrew, Windows Chocolatey 등)
  • 스크립트 설치
  • 소스 빌드 설치 가능

• 설치 확인

helm version

3) Chart, Release & Repository 개념 상세

• Chart 구조
  • 메타데이터(Chart.yaml), 기본값(values.yaml), 템플릿 디렉토리 등으로 구성됨.
• Release
  • 하나의 설치 인스턴스이며 동일 차트를 여러 Release로 배포 가능.
• Repository
  • 외부 또는 내부 저장소에서 차트를 가져오고 관리함.

4) 필수 Helm 명령어 Cheat Sheet

• 배포/업그레이드/롤백

명령어	설명
helm install <name> <chart>	새로운 릴리즈 설치
helm upgrade <name> <chart>	릴리즈 업그레이드
helm upgrade --install <name> <chart>	릴리즈 없으면 설치, 있으면 업그레이드
helm rollback <name> <revision>	지정 revision으로 롤백

---

• 릴리즈 & 저장소 관리

명령어	설명
helm list	릴리즈 목록
helm uninstall <name>	릴리즈 제거
helm repo add <name> <url>	저장소 추가
helm repo update	저장소 업데이트
helm repo list	저장소 목록
helm search repo <term>	저장소 내 차트 검색
helm search hub <term>	Artifact Hub 전체 검색

• 조회 및 설정

명령어	설명
helm show values <chart>	값 템플릿 보기
helm pull <chart> --untar	차트 아카이브 다운로드 및 압축 해제
helm env	Helm 환경 변수 확인

5) 고급 옵션 및 활용

• Custom Values 적용

helm install <name> <chart> --values custom-values.yaml

또는

helm install <name> <chart> --set key=value

• 헬름 플러그인
  • Helm 기능 확장용 플러그인 설치/관리 가능.
  • 예: diff, secrets 등. Faun

[출처] Helm Cheat Sheet: Everything You Need to Know to Start Using Helm