Helm - CLI

Helm 설치가 끝났다면, 이제 “Helm로 뭘 할 수 있는지”를 커맨드 중심으로 빠르게 익히면 됩니다. Helm의 모든 작업은 Helm CLI로 수행하며, 설치/업그레이드/롤백/삭제 같은 액션을 “애플리케이션(릴리즈) 단위”로 다룹니다.

---

1) helm help: 인터넷 검색 대신 CLI에서 바로 힌트 얻기

Helm은 help가 잘 되어 있어서, 명령이 기억 안 날 때 인터넷을 찾기보다 CLI에서 바로 확인하는 편이 빠릅니다.

helm help

예를 들어, “업그레이드 실패 후 이전 버전으로 되돌리고 싶다”면
helm restore 같은 걸 떠올릴 수 있는데, help를 보면 정확한 명령은 rollback임을 바로 확인할 수 있습니다.

helm rollback --help

서브커맨드 help도 가능

repo 관련 작업이 뭐가 있는지 보고 싶다면:

helm repo --help

더 깊게 들어가서 옵션까지 확인:

helm repo add --help
helm repo update --help

---

2) 차트(Chart) 찾기: 웹(Artifact Hub) vs CLI 검색

방법 A) 웹에서 찾기: Artifact Hub

강의 흐름대로라면 WordPress 같은 앱을 설치하려고 할 때:

• artifacthub.io에서 검색
• 가능하면 Official / Verified publisher 배지가 있는 차트를 우선 고려
• 차트 페이지에서:
  • 설치 명령(helm repo add / helm install)
  • 사용 컴포넌트(예: WordPress + DB)
  • 주요 설정값(values) 예시
    등을 확인할 수 있습니다.

차트 상세 페이지에 어떤 설정이 노출될지는 차트 개발자가 문서에 얼마나 써놨는지에 따라 달라집니다. 그래서 CLI로 helm show values를 보는 습관이 중요합니다.

---

방법 B) CLI에서 찾기: helm search

helm search는 어디를 검색할지 서브커맨드가 필요합니다.

• hub: Artifact Hub(허브) 검색
• repo: 내가 로컬에 추가한 repo들만 검색

Hub 검색(Artifact Hub 기준)

helm search hub wordpress

Repo 검색(내 로컬 Helm에 등록된 repo 기준)

helm search repo wordpress

검색 결과에는 보통 다음이 함께 표시됩니다.

• 차트 이름
• 차트 버전
• appVersion(해당 차트가 배포하는 앱 버전, 예: WordPress 버전)

---

3) 설치 흐름: (1) repo 추가 → (2) install

강의에서는 Bitnami WordPress 차트를 예시로 듭니다. 설치는 보통 2단계입니다.

3-1) repo 추가

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

repo를 추가해야 helm install bitnami/wordpress ...처럼 “어디서 차트를 가져올지” Helm이 알 수 있습니다.

3-2) (권장) repo 인덱스 업데이트

helm repo update

3-3) 차트 설치(= release 생성)

helm install my-release bitnami/wordpress

• bitnami/wordpress = 차트
• my-release = 릴리즈 이름(설치본 식별자)

설치가 끝나면 출력되는 안내 문구가 있는데, 이건 차트에 포함된 NOTES.txt 같은 안내 템플릿에서 생성되는 경우가 많습니다. 보통:

• 접속 방법
• 초기 패스워드 확인
• 포트 포워딩 예시
  같은 “설치 후 다음 단계”가 적혀 있습니다.

---

4) 설치된 릴리즈 확인: helm list

차트를 설치하면 클러스터에는 “릴리즈”가 생깁니다. 설치된 릴리즈 목록은:

helm list

네임스페이스를 쓰는 경우(권장):

helm list -n <namespace>

이게 유용한 이유:

• 무엇이 설치되어 있는지 추적
• 오래 업데이트되지 않은 릴리즈(잠재적 리스크) 파악

---

5) 삭제(언인스톨): “관련 오브젝트를 한 번에 정리”

WordPress 같은 앱을 수동으로 지우려면 Deployment, Service, Secret, PVC 등 다 찾아서 하나씩 지워야 합니다.
Helm은 릴리즈 단위로 추적하고 있으므로 한 번에 제거 가능합니다.

helm uninstall my-release

네임스페이스를 썼다면:

helm uninstall my-release -n <namespace>

---

6) repo 관리 명령들: add / list / update / remove

Helm repo 관련 주요 명령은 다음 네 가지입니다.

repo 목록

helm repo list

repo 추가

helm repo add <repo-name> <repo-url>

repo 업데이트(로컬 인덱스 갱신)

강의에서 apt의 update에 비유한 부분입니다.

• Helm은 repo 정보를 로컬에 캐시 형태로 들고 있고
• 시간이 지나면 원격 repo는 차트 버전/메타데이터가 바뀌므로
• 로컬 인덱스가 “낡을 수” 있습니다.

그래서 업데이트:

helm repo update

repo 제거

helm repo remove <repo-name>

---

실습용 최소 명령 세트(강의 흐름 그대로)

helm help
helm repo --help

helm search hub wordpress

helm repo add bitnami https://charts.bitnami.com/bitnami
helm repo update
helm search repo wordpress

helm install my-release bitnami/wordpress
helm list
helm uninstall my-release

.