Quickstart 가이드

Quickstart 가이드

이 가이드는 Helm을 빠르게 시작하는 방법을 다뤄요. 성공적이고 안전한 Helm 사용을 위한 전제 조건(빌드 준비)은 다음과 같아요.

출처: https://helm.sh/docs/intro/quickstart/

  1. Kubernetes 클러스터
  2. 설치에 적용할 보안 설정 결정(있다면)
  3. Helm 설치·구성

Kubernetes가 설치돼 있어야 하고, 최신 Helm 버전에는 최신 안정 Kubernetes(대개 두 번째로 새로운 마이너 릴리스)를 권장해요. 로컬에 구성된 kubectl 복사본도 있어야 해요. Helm과 Kubernetes 사이의 최대 버전 스큐는 Helm Version Support Policy에서 확인할 수 있어요.

차트 찾기

Artifact Hub는 Helm 차트를 발견하기 가장 좋은 곳이에요. 수백 개 리포지토리의 차트를 모아 검색·메타데이터·보안 정보를 제공해요.

  • OCI 레지스트리 — 많은 조직이 차트를 GHCR, Docker Hub, 클라우드 제공자 레지스트리 같은 컨테이너 레지스트리에 게시해요. oci:// 접두사로 직접 설치할 수 있어요.
  • 차트 리포지토리 — 전통적인 Helm 리포지토리는 helm repo add로 추가하고 helm search repo로 검색해요.

명령줄에서 Artifact Hub를 검색하려면:

$ helm search hub podinfo

차트 설치

Helm은 먼저 리포지토리를 추가할 필요 없이 OCI 호환 컨테이너 레지스트리에서 직접 차트를 설치할 수 있어요. oci:// 접두사를 쓰면 돼요.

$ helm install my-podinfo oci://ghcr.io/stefanprodan/charts/podinfo --version 6.11.2

설치가 잘 됐는지 확인하려면 서비스 포트를 포워딩하고 엔드포인트를 테스트하면 돼요.

$ kubectl port-forward svc/my-podinfo 9898:9898 &
$ curl http://localhost:9898

설치 전에 차트에 무엇이 들어있는지 미리 볼 수도 있어요.

$ helm show chart oci://ghcr.io/stefanprodan/charts/podinfo --version 6.11.2

OCI 레지스트리 작업에 대한 자세한 내용은 Use OCI-based registries 문서를 참고하세요.

릴리스 관리

helm list(또는 helm ls)로 배포된 모든 릴리스의 목록을 볼 수 있어요.

$ helm list

릴리스를 언인스톨하려면 helm uninstall 명령을 써요.

$ helm uninstall my-podinfo

이렇게 하면 my-podinfo가 Kubernetes에서 언인스톨돼 릴리스와 연관된 모든 리소스 및 릴리스 히스토리가 제거돼요. --keep-history 플래그를 주면 릴리스 히스토리가 유지돼서 helm status로 그 릴리스 정보를 요청할 수 있고, helm rollback으로 릴리스를 복구(undelete)할 수도 있어요.

더 많은 Helm 명령을 배우려면 helm help를 쓰거나 명령 뒤에 -h 플래그를 붙이면 돼요.

$ helm get -h

더 알아보기