4장. Helm CLI
4.1. Helm 3 시작하기
4.1.1. Helm 이해
Helm은 OpenShift Container Platform 클러스터에 대한 애플리케이션 및 서비스 배포를 간소화하는 소프트웨어 패키지 관리자입니다.
Helm은 차트라는 패키징 형식을 사용합니다. Helm 차트는 OpenShift Container Platform 리소스에 대해 설명하는 파일 컬렉션입니다.
클러스터에 있는 차트의 실행 중인 인스턴스를 릴리스라고 합니다. 클러스터에 차트가 설치될 때마다 새 릴리스가 생성됩니다.
차트를 설치하거나 릴리스를 업그레이드하거나 롤백할 때마다 번호가 증가한 리버전이 생성됩니다.
4.1.1.1. 주요 기능
Helm은 다음을 수행할 수 있는 기능을 제공합니다.
- 차트 리포지토리에 저장된 대규모 차트 컬렉션에서 검색합니다.
- 기존 차트를 수정합니다.
- OpenShift Container Platform 또는 Kubernetes 리소스를 사용하여 자체 차트를 생성합니다.
- 애플리케이션을 차트로 패키징하고 공유합니다.
4.1.2. Helm 설치
다음 섹션에서는 CLI를 사용하여 다양한 플랫폼에 Helm을 설치하는 방법을 설명합니다.
오른쪽 상단에 있는 ? 아이콘을 클릭하고 명령줄 툴을 선택하여 OpenShift Container Platform 웹 콘솔의 최신 바이너리 URL을 찾을 수도 있습니다.
사전 요구 사항
- Go 버전 1.13 이상이 설치되어 있어야 합니다.
4.1.2.1. On Linux
Helm 바이너리를 다운로드하여 경로에 추가합니다.
# curl -L https://mirror.openshift.com/pub/openshift-v4/clients/helm/latest/helm-linux-amd64 -o /usr/local/bin/helm
바이너리 파일을 실행 가능하게 합니다.
# chmod +x /usr/local/bin/helm
설치된 버전을 확인합니다.
$ helm version
출력 예
version.BuildInfo{Version:"v3.0", GitCommit:"b31719aab7963acf4887a1c1e6d5e53378e34d93", GitTreeState:"clean", GoVersion:"go1.13.4"}
4.1.2.2. Windows 7/8
-
최신
.exe파일을 다운로드하여 기본 설정 디렉터리에 배치합니다. - 시작을 마우스 오른쪽 버튼으로 클릭하고 제어판을 클릭합니다.
- 시스템 및 보안을 선택하고 시스템을 클릭합니다.
- 왼쪽 메뉴에서 고급 시스템 설정을 선택하고 아래에 있는 환경 변수를 클릭합니다.
- 변수 섹션에서 경로를 선택하고 편집을 클릭합니다.
-
새로 생성을 클릭하고 필드에
.exe파일이 있는 폴더의 경로를 입력하거나 검색을 클릭하고 디렉터리를 선택한 후 확인을 클릭합니다.
4.1.2.3. Windows 10
-
최신
.exe파일을 다운로드하여 기본 설정 디렉터리에 배치합니다. -
검색을 클릭하고
env또는environment를 입력합니다. - 계정의 환경 변수 편집을 선택합니다.
- 변수 섹션에서 경로를 선택하고 편집을 클릭합니다.
- 새로 생성을 클릭하고 필드에 exe 파일이 있는 디렉터리의 경로를 입력하거나 검색을 클릭하고 디렉터리를 선택한 후 확인을 클릭합니다.
4.1.2.4. MacOS
Helm 바이너리를 다운로드하여 경로에 추가합니다.
# curl -L https://mirror.openshift.com/pub/openshift-v4/clients/helm/latest/helm-darwin-amd64 -o /usr/local/bin/helm
바이너리 파일을 실행 가능하게 합니다.
# chmod +x /usr/local/bin/helm
설치된 버전을 확인합니다.
$ helm version
출력 예
version.BuildInfo{Version:"v3.0", GitCommit:"b31719aab7963acf4887a1c1e6d5e53378e34d93", GitTreeState:"clean", GoVersion:"go1.13.4"}
4.1.3. OpenShift Container Platform 클러스터에 Helm 차트 설치
사전 요구 사항
- 실행 중인 OpenShift Container Platform 클러스터가 있고 로그인되어 있어야 합니다.
- Helm이 설치되어 있어야 합니다.
절차
새 프로젝트를 생성합니다.
$ oc new-project mysql
로컬 Helm 클라이언트에 Helm 차트 리포지터리를 추가합니다.
$ helm repo add stable https://kubernetes-charts.storage.googleapis.com/
출력 예
"stable" has been added to your repositories
리포지터리를 업데이트합니다.
$ helm repo update
MySQL 차트 예를 설치합니다.
$ helm install example-mysql stable/mysql
차트가 성공적으로 설치되었는지 확인합니다.
$ helm list
출력 예
NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION example-mysql mysql 1 2019-12-05 15:06:51.379134163 -0500 EST deployed mysql-1.5.0 5.7.27
4.1.4. OpenShift Container Platform에서 사용자 정의 Helm 차트 생성
절차
새 프로젝트를 생성합니다.
$ oc new-project nodejs-ex-k
OpenShift Container Platform 오브젝트가 포함된 Node.js 차트 예를 다운로드합니다.
$ git clone https://github.com/redhat-developer/redhat-helm-charts
샘플 차트가 있는 디렉터리로 이동합니다.
$ cd redhat-helm-charts/alpha/nodejs-ex-k/
Chart.yaml파일을 편집하고 차트에 대한 설명을 추가합니다.apiVersion: v2 1 name: nodejs-ex-k 2 description: A Helm chart for OpenShift 3 icon: https://static.redhat.com/libs/redhat/brand-assets/latest/corp/logo.svg 4
차트 형식이 올바르게 지정되었는지 확인합니다.
$ helm lint
출력 예
[INFO] Chart.yaml: icon is recommended 1 chart(s) linted, 0 chart(s) failed
이전 디렉터리 수준으로 이동합니다.
$ cd ..
차트를 설치합니다.
$ helm install nodejs-chart nodejs-ex-k
차트가 성공적으로 설치되었는지 확인합니다.
$ helm list
출력 예
NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION nodejs-chart nodejs-ex-k 1 2019-12-05 15:06:51.379134163 -0500 EST deployed nodejs-0.1.0 1.16.0
