Helm 설치(Installing Helm)

Helm 설치(Installing Helm)

이 가이드는 Helm CLI를 설치하는 방법을 보여줘요. Helm은 소스에서 또는 사전 빌드된 바이너리 릴리스에서 설치할 수 있어요. Helm 프로젝트는 공식 방법 두 가지(릴리스 다운로드, 설치 스크립트)를 제공하고, 커뮤니티는 다양한 패키지 매니저로 설치하는 방법을 제공해요.

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

공식 방법: 바이너리 릴리스

매 Helm 릴리스는 다양한 OS용 바이너리 릴리스를 제공해요. 직접 다운로드해서 설치할 수 있어요.

  1. 원하는 버전을 다운로드
  2. 바이너리 검증(이 페이지의 "Verifying Helm Binaries" 참고)
  3. 압축 해제 (tar -zxvf helm-v4.0.0-linux-amd64.tar.gz)
  4. 압축 해제한 디렉토리에서 helm 바이너리를 찾아 원하는 위치로 이동 (mv linux-amd64/helm /usr/local/bin/helm)

이제 helm help로 클라이언트를 실행하고 차트를 찾아 설치할 수 있어요.

참고: Helm 자동화 테스트는 GitHub Actions 빌드·릴리스 중 Linux AMD64에서만 수행돼요. 다른 OS 테스트는 해당 OS를 요청하는 커뮤니티의 책임이에요.

공식 방법: 설치 스크립트

Helm은 최신 버전을 자동으로 가져와 설치하는 설치 스크립트를 제공해요. 스크립트를 내려받아 로컬에서 실행할 수 있는데, 실행 전에 내용을 읽고 이해할 수 있게 잘 문서화돼 있어요.

curl -fsSL -o get_helm.sh https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-4
chmod 700 get_helm.sh
./get_helm.sh

커뮤니티 방법: 패키지 매니저

Helm 커뮤니티는 OS 패키지 매니저로 설치하는 방법을 제공해요. 이들은 Helm 프로젝트가 지원하지 않고 신뢰할 수 있는 서드파티로도 간주되지 않아요.

  • Homebrew (macOS/Linux): brew install helm
  • Chocolatey (Windows): choco install kubernetes-helm
  • Scoop (Windows): scoop install helm
  • Winget (Windows): winget install Helm.Helm
  • Apt (Debian/Ubuntu): 지정된 apt 저장소를 추가하고 sudo apt-get install helm
  • DNF (Fedora 35+): sudo dnf install helm
  • Snap: sudo snap install helm --classic
  • FreeBSD: pkg install helm

각 매니저별 지침은 공식 문서에 자세히 나와 있어요.

크레나리(Canary) 빌드와 소스 빌드

릴리스 외에도 개발 스냅샷을 다운로드하거나 설치할 수 있어요. "Canary" 빌드는 최신 main 브랜치에서 만든 버전으로, 공식 릴리스가 아니고 안정적이지 않을 수 있지만 최첨단 기능을 테스트할 기회를 줘요. 소스에서 빌드하려면 Go 환경이 필요하고:

git clone https://github.com/helm/helm.git
cd helm
make

필요하면 의존성을 가져와 캐시하고 구성을 검증한 뒤 helm을 컴파일해 bin/helm에 넣어요.

바이너리 검증(Verifying Helm Binaries)

각 Helm 릴리스는 Helm 유지보수자가 빌드·서명했음을 확인하는 암호화 서명을 포함해요. 공급망 공격을 막으려면 설치 전에 Helm 바이너리의 진위를 항상 검증해야 해요. 검증에는 바이너리 아카이브, 대응하는 서명 파일(.asc), Helm 유지보수자의 공개 PGP 키가 필요해요.

  1. SHA256 체크섬으로 다운로드가 손상되지 않았는지 확인: sha256sum -c helm-v4.0.0-linux-amd64.tar.gz.sha256sum
  2. Helm 유지보수자의 공개 키 import: curl .../helm/main/KEYS | gpg --import (키는 한 번 import한 뒤 안전한 곳에 보관 권장)
  3. 바이너리 서명 검증: gpg --verify helm-v4.0.0-linux-amd64.tar.gz.asc helm-v4.0.0-linux-amd64.tar.gz — "Good signature" 메시지가 진위 확인.

파일 위치

Helm은 파일 저장에 XDG 구조를 사용하고, 환경 변수로 위치를 바꿀 수 있어요. $XDG_CACHE_HOME(캐시), $XDG_CONFIG_HOME(구성), $XDG_DATA_HOME(데이터)이에요. 기존 리포지토리가 있다면 helm repo add로 다시 추가해야 해요. OS별 기본 폴더는 OS에 따라 다르고(예: Linux는 $HOME/.cache/helm, $HOME/.config/helm, $HOME/.local/share/helm), 표는 공식 문서에서 확인할 수 있어요.

더 알아보기