빠른 시작 가이드
빠른 시작 가이드
Helm을 설치하고 시작하는 방법에 대한 가이드입니다(배포판별 지침, FAQ, 플러그인 포함).
출처: 문서
본문
이 가이드는 Helm을 빠르게 시작하는 방법을 다룹니다.
사전 요구 사항 (Prerequisites)
Helm을 성공적이고 안전하게 사용하려면 다음 사전 요구 사항이 필요합니다.
- Kubernetes 클러스터
- 설치에 적용할 보안 구성을 결정할 것(있는 경우)
- Helm 설치 및 구성
Kubernetes 설치 또는 클러스터 접근 권한 확보
- Kubernetes가 설치되어 있어야 합니다. 최신 Helm 릴리스에는 최신 안정 버전의 Kubernetes를 권장하며, 대부분의 경우 두 번째로 최신인 마이너 릴리스입니다.
- 로컬에 구성된
kubectl사본도 있어야 합니다.
Helm과 Kubernetes 사이에 지원되는 최대 버전 편차는 Helm Version Support Policy를 참조하세요.
Helm 설치 (Install Helm)
Helm 클라이언트의 바이너리 릴리스를 다운로드하세요. homebrew 같은 도구를 사용하거나 공식 릴리스 페이지를 확인할 수 있습니다.
자세한 내용이나 다른 옵션은 설치 가이드를 참조하세요.
설치할 차트 찾기 (Find Charts to Install)
Artifact Hub는 Helm 차트를 발견하기 가장 좋은 곳입니다. 수백 개의 리포지토리의 차트를 모아 검색, 메타데이터, 보안 정보를 제공합니다.
인기 있는 차트 소스는 다음과 같습니다.
- OCI 레지스트리: 많은 조직이 GitHub Container Registry, Docker Hub, 클라우드 제공자 레지스트리 같은 컨테이너 레지스트리에 차트를 게시합니다.
oci://접두사를 사용해 직접 설치할 수 있습니다. - 차트 리포지토리: 전통적인 Helm 리포지토리는
helm repo add로 추가하고helm search repo로 검색할 수 있습니다.
명령줄에서 Artifact Hub를 검색하려면:
$ helm search hub podinfo
URL CHART VERSION APP VERSION DESCRIPTION
https://artifacthub.io/packages/helm/podinfo/po... 6.11.2 6.11.2 Podinfo Helm chart for Kubernetes
OCI 레지스트리에서 차트 설치 (Install a Chart from an OCI Registry)
Helm은 OCI 규격 컨테이너 레지스트리에서 차트를 직접 설치할 수 있습니다. 이 방법은 먼저 리포지토리를 추가할 필요가 없습니다.
OCI 레지스트리에서 차트를 설치하려면 oci:// 접두사를 사용하세요.
$ helm install my-podinfo oci://ghcr.io/stefanprodan/charts/podinfo --version 6.11.2
Pulled: ghcr.io/stefanprodan/charts/podinfo:6.11.2
NAME: my-podinfo
LAST DEPLOYED: Sat May 3 12:05:00 2026
NAMESPACE: default
STATUS: deployed
REVISION: 1
NOTES: ...
설치가 동작하는지 검증하려면 서비스 포트를 포워딩하고 엔드포인트를 테스트하세요.
$ kubectl port-forward svc/my-podinfo 9898:9898 &
$ curl http://localhost:9898
{
"hostname": "podinfo-6f89b4c6b5-xvwtb",
"version": "6.7.1",
"message": "greetings from podinfo v6.7.1",
"goos": "linux",
"goarch": "amd64",
...
}
설치 전에 차트가 무엇을 포함하는지 미리 볼 수 있습니다.
$ helm show chart oci://ghcr.io/stefanprodan/charts/podinfo --version 6.11.2
OCI 레지스트리 작업에 대한 자세한 내용은 OCI 기반 레지스트리 사용을 참조하세요.
릴리스 알아보기 (Learn About Releases)
Helm을 사용해 배포된 것을 쉽게 확인할 수 있습니다.
$ helm list
NAME \tNAMESPACE\tREVISION\tUPDATED \tSTATUS \tCHART \tAPP VERSION
my-podinfo \tdefault \t1 \t2026-05-03 12:05:00.000000 +0000 UTC\tdeployed\tpodinfo-6.11.2\t6.7.1
helm list(또는 helm ls)는 배포된 모든 릴리스의 목록을 보여줍니다.
릴리스 제거 (Uninstall a Release)
릴리스를 제거하려면 helm uninstall 명령을 사용하세요.
$ helm uninstall my-podinfo
release "my-podinfo" uninstalled
이렇게 하면 Kubernetes에서 my-podinfo가 제거되어 릴리스와 연결된 모든 리소스와 릴리스 기록이 제거됩니다.
--keep-history 플래그를 주면 릴리스 기록이 유지됩니다. 해당 릴리스에 대한 정보를 요청할 수 있습니다.
$ helm status my-podinfo
Status: UNINSTALLED
...
Helm은 릴리스를 제거한 후에도 추적하므로 클러스터 기록을 감사하고, 심지어 릴리스를 되살릴 수도 있습니다(helm rollback 사용).
도움말 텍스트 읽기 (Reading the Help Text)
사용 가능한 Helm 명령에 대해 더 자세히 알려면 helm help를 사용하거나 명령 뒤에 -h 플래그를 붙이세요.
$ helm get -h