퀵스타트 가이드

이 가이드는 헬름을 빠르게 시작하는 방법에 대해 다룬다.

전제 조건

헬름을 성공적이고 안전하게 사용하려면 다음과 같은 전제 조건들이 필요하다.

  1. 쿠버네티스 클러스터
  2. 설치를 위해 어떤 보안 구성을 사용할 것인지 결정하기(필요시)
  3. 헬름 설치 및 구성

쿠버네티스 설치 혹은 클러스터에 접근

  • 쿠버네티스가 설치되어 있어야 한다. 최신 릴리스의 헬름을 사용하기 위해서, 대부분의 경우 두번째 최신 마이너 릴리스 버전인 쿠버네티스 최신 안정(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