본문으로 건너뛰기

Helm 명령어

Helm 주요 CLI 명령어​

Help​

helm --help
  • 명령어가 기억나지 않을 때 빠르게 확인하는 명령어
helm repo --help
  • 레포지토리 관련 명령어 확인
  • 하위 명령어가 기억나지 않을 때 --help 플래그를 붙여 찾을 수 있다.
helm search hub wordpress
  • Artifact Hub에서 검색하는 명령어
helm search repo wordpress
  • 내 로컬에 등록된 레포지토리 내에서만 검색하는 명령어

Repo​

helm repo add bitnami https://charts.bitnami.com/bitnami
  • 레포지토리 추가 명령어
helm repo update
  • 레포지토리 업데이트 명령어 (apt-get update 처럼 최신 차트 정보를 가져온다고 생각하면 됨)
helm repo list
  • 로컬에 현재 등록된 레포지토리 목록 확인 명령어

Install (Default)​

helm install my-release bitnami/wordpress
  • bitnami 레포지토리의 wordpress를 설치하는 명령어 (기본 설정값 그대로 설치)

Install (Custom)​

  • 이전 명령어는 기본 설정값을 그대로 사용하여 설치하엿지만, 보통 설정을 수정하여 사용한다.
  • 이렇게 커스텀하는 방법은 여러가지가 있다.
helm install my-release bitnami/wordpress \
  --set wordpressBlogName="Helm Tutorials" \
  --set userEmail="john@example.com"
  • 방법1
  • --set 옵션을 사용할 수 있다.
  • 변경할 설정이 적을 때 사용하면 좋은 방법이다.
helm install my-release bitnami/wordpress -f custom-values.yaml
  • 방법2
  • custom-values.yaml 과 같은 이름으로 파일을 생성한다.
  • 변경할 변수들을 key: value 형식의 yaml 형식으로 작성한다.
  • 설치시 -f 옵션으로 파일을 지정하여 설치한다.
  • 그러면 디폴트 values.yaml의 값보다 custom-values.yaml의 값이 우선된다.
helm pull bitnami/wordpress --untar
helm install my-release ./wordpress
  • 방법3
  • 이전 명령어는 기본 설정값을 그대로 사용하여 설치하엿지만, 보통 설정을 수정하여 사용한다.
  • 이럴 때, 해당 차트의 values.yaml를 수정하여 설치한다.
  • 위 명령어로 차트 전체를 pull 해서 이 안에 있는 values.yaml을 수정한다.
  • 이후 pull한 차트를 기밚으로 설치한다.

Upgrade​

helm upgrade my-release bitnami/wordpress
  • 예를들어 내가 설치한 버전의 워드프레스가 보안 취약점이 발견되어 업데이트 되었다고 하자.
  • 이 때 나의 클러스터에 Helm으로 배포된 워드프레스도 업그레이드 해야할 때
  • 단순히 위 명령어로 업데이트 할 수 있다. (같은 Release 내에 새로운 Revision이 생긴다)

History & Rollback​

helm history my-release
  • 이러한 업그레이드나 특정 옵션 수정과 같은 변경 사항이 Revision에 기록된다.
  • 이를 조회하는 명령어이다.
helm rollback my-release 1
  • 1번 Revision으로 롤백하는 명령어이다. (현재 Revision 2라고 하자)
  • 실제로 1번 Revision으로 돌아가는 것이 아니라, 1번 Revision과 똑같은 Revision 3을 만드는 것이다.
  • 당연한 얘기이지만, 이 롤백 과정을 수행하는 것은 Helm이 관리하는 쿠버네티스 리소스들의 롤백이다. 외부에 연결된 DB와 같은 외부 자원은 롤백되는 것이 아니다.

List & Uninstall​

helm list
  • 현재 설치된 Release들과 업데이트 현황을 조회하는 명령어이다.
helm uninstall my-release
  • Helm을 사용하기 전에는 수동으로 Deployment, Service, Secret 등을 하나하나 지워야했지만 이 명령어로 이러한 자원들을 한번에 삭제할 수 있다.

레퍼런스​