퀵스타트 가이드
이 가이드는 헬름을 빠르게 시작하는 방법에 대해 다룬다.
전제 조건
헬름을 성공적이고 안전하게 사용하려면 다음과 같은 전제 조건들이 필요하다.
- 쿠버네티스 클러스터
- 설치를 위해 어떤 보안 구성을 사용할 것인지 결정하기(필요시)
- 헬름 설치 및 구성
쿠버네티스 설치 혹은 클러스터에 접근
- 쿠버네티스가 설치되어 있어야 한다. 최신 릴리스의 헬름을 사용하기 위해서, 대부분의 경우 두번째 최신 마이너 릴리스 버전인 쿠버네티스 최신 안정(latest stable) 릴리스 버전 설치를 권장한다.
- 또한 로컬로 구성된
kubectl복사본이 있어야 한다.
참고: 1.6 이전의 쿠버네티스 버전은 역할 기반 접근 제어(RBAC)가 제한되거나 제공되지 않는다.
헬름 설치
헬름 클라이언트의 바이너리 릴리스를 다운로드한다. homebrew 와 같은 툴을 사용하거나
공식 릴리스 페이지를 참고하면 된다.
자세한 내용이나 다른 옵션에 대해서는 설치 가이드를 참고한다.
헬름 차트 리포지토리 초기화
헬름이 준비되면, 차트 리포지토리를 추가할 수 있다. 처음에 주로 사용하는 곳은 공식 헬름 stable 차트들이다:
$ helm repo add stable https://charts.helm.sh/stable
차트 리포지토리 추가가 완료되면 설치할 수 있는 차트들의 목록을 볼 수 있다.
helm search repo stable
NAME CHART VERSION APP VERSION DESCRIPTION
stable/acs-engine-autoscaler 2.2.2 2.1.1 DEPRECATED Scales worker nodes within agent pools
stable/aerospike 0.2.8 v4.5.0.5 A Helm chart for Aerospike in Kubernetes
stable/airflow 4.1.0 1.10.4 Airflow is a platform to programmatically autho...
stable/ambassador 4.1.0 0.81.0 A Helm chart for Datawire Ambassador
# ... and many more
예제 차트 설치
차트를 설치하기 위해서, helm install 커맨드를 실행한다.
헬름은 차트를 설치하기 위한 몇가지 방법들이 존재하는데, 가장 쉬운 방법은 공식적인 stable 차트들을 이용하는 것이다.
$ helm repo update # Make sure we get the latest list of charts
$ helm install stable/mysql --generate-name
Released smiling-penguin
위의 예에서, stable/mysql 차트가 릴리스되었고,
새로운 릴리스의 이름은 smiling-penguin 이다.
MySQL 차트에 대한 간단한 정보를 보려면
helm show chart stable/mysql 를 실행한다. 또는 차트에 대한 모든 정보를 보려면 helm show all stable/mysql
를 실행할 수도 있다.
차트를 설치할 때마다, 새로운 릴리스가 생성된다. 따라서 하나의 차트를 동일한 클러스터에 여러 번 설치할 수 있다. 각각을 독립적으로 관리 및 업그레이드 할 수 있다.
helm install 커맨드는 다양한 기능을 가진 매우 강력한 커맨드이다. 더 많은 정보를 얻으려면, 이곳을 확인하면 된다.
헬름 사용 가이드
릴리스에 대해 알아보기
헬름을 사용하여 릴리스된 내용을 쉽게 확인할 수 있다.
$ helm ls
NAME VERSION UPDATED STATUS CHART
smiling-penguin 1 Wed Sep 28 12:59:46 2016 DEPLOYED mysql-0.1.0
helm list 함수는 배포된 모든 릴리스 목록을 보여준다.
릴리스 설치 제거
릴리스를 설치 제거하려면, helm uninstall 커맨드를 사용한다.
$ helm uninstall smiling-penguin
Removed smiling-penguin
쿠버네티스에서 smiling-penguin 를 설치 제거하면, 릴리스 이력 뿐 아니라
릴리스와 관련된 리소스들도 모두 제거된다.
--keep-history 플래그가 제공되면, 릴리스 이력은 유지된다. 그러면
릴리스에 대한 정보를 요청할 수 있다.
$ helm status smiling-penguin
Status: UNINSTALLED
...
헬름은 릴리스를 제거한 후에도 릴리스를 추적하므로, 클러스터 이력을
감사(audit)할 수 있고, 릴리스 삭제 취소도 가능하다. (helm rollback을 사용)
도움말 읽기
헬름 커맨드 사용법에 대해 더 배우려면, helm help 을 사용하거나
커맨드 뒤에 -h 플래그를 사용한다.
$ helm get -h
