Helm을 사용하여 마이크로서비스 배포

본 실습 에서는 kubectl을 사용하여 모든 작업을 수동으로 수행하는 대신 사용자 지정 Helm 차트를 사용하여 마이크로 서비스를 배포하는 방법을 확인합니다.

차트 템플릿 작업에 대한 자세한 내용은 Helm 문서를 참조 하십시오.

1. 차트 생성

Helm 차트는 다음과 유사한 구조를 갖습니다.

/eksdemo
  /Chart.yaml  # a description of the chart
  /values.yaml # defaults, may be overridden during install or upgrade
  /charts/     # May contain subcharts
  /templates/  # the template files themselves
  ...

이 템플릿을 따르고 다음 명령을 사용하여 eksdemo라는 새 차트를 만듭니다.

cd ~/environment
helm create eksdemo

2. 사용자 기본값 지정

새로 생성 된 eksdemo 디렉토리를 보면 여러 파일과 디렉토리를 볼 수 있습니다. 특히 /templates 디렉토리 안에 다음이 표시됩니다.

• deployment.yaml : 쿠버네티스 배포를 만들기 위한 기본 매니페스트.

• _helpers.tpl : 차트 전체에서 재 사용 할 수 있는 템플릿 도우미를 배치하는 공간.

• ingress.yaml : 서비스 용 쿠버네티스 수신 객체를 만들기 위한 기본 매니페스트.

• NOTES.txt : 차트의 “도움말 텍스트”. 사용자가 helm 설치를 실행할 때 표시 됩니다.

• serviceaccount.yaml : 서비스 계정을 만들기 위한 기본 매니페스트.

• service.yaml : 배포를 위한 서비스 엔드 포인트를 만들기 위한 기본 매니페스트.

• tests /: 차트에 대한 테스트를 포함하는 폴더

직접 사용할 파일을 만들 것이므로 기본 파일을 삭제 합니다.

rm -rf ~/environment/eksdemo/templates/
rm ~/environment/eksdemo/Chart.yaml
rm ~/environment/eksdemo/values.yaml

차트를 설명 할 새 Chart.yaml 파일을 만듭니다.

cat <<EoF > ~/environment/eksdemo/Chart.yaml
apiVersion: v2
name: eksdemo
description: A Helm chart for EKS Workshop Microservices application
version: 0.1.0
appVersion: 1.0
EoF

다음으로 각 마이크로 서비스의 manifest 파일을 servicename.yaml로 템플릿 디렉터리에 복사합니다.

#create subfolders for each template type
mkdir -p ~/environment/eksdemo/templates/deployment
mkdir -p ~/environment/eksdemo/templates/service

# Copy and rename frontend manifests
cp ~/environment/ecsdemo-frontend/kubernetes/deployment.yaml ~/environment/eksdemo/templates/deployment/frontend.yaml
cp ~/environment/ecsdemo-frontend/kubernetes/service.yaml ~/environment/eksdemo/templates/service/frontend.yaml

# Copy and rename crystal manifests
cp ~/environment/ecsdemo-crystal/kubernetes/deployment.yaml ~/environment/eksdemo/templates/deployment/crystal.yaml
cp ~/environment/ecsdemo-crystal/kubernetes/service.yaml ~/environment/eksdemo/templates/service/crystal.yaml

# Copy and rename nodejs manifests
cp ~/environment/ecsdemo-nodejs/kubernetes/deployment.yaml ~/environment/eksdemo/templates/deployment/nodejs.yaml
cp ~/environment/ecsdemo-nodejs/kubernetes/service.yaml ~/environment/eksdemo/templates/service/nodejs.yaml

템플릿 디렉토리의 모든 파일은 템플릿 엔진을 통해 전송 됩니다. 이는 현재 쿠버네티스에 있는 그대로 전송되는 일반 YAML 파일입니다.

3. values.yaml 파일 만들기

하드 코딩 된 값을 제거하여 더 많은 사용자 정의를 가능하게 하기 위해 일부 값을 template directives로 대체 해 보겠습니다.

Cloud9 편집기에서 ~/environment/eksdemo/templates/deployment/frontend.yaml을 엽니다.

• spec에서 replicas : 1을 찾아 으로 바꿉니다:

  {{ .Values.replicas }}

• spec.template.spec.containers.image에서 이미지를 아래 표의 올바른 템플릿 값으로 바꿉니다:

  Filename	Value
  frontend.yaml	- image: {{ .Values.frontend.image }}:{{ .Values.version }}
  crystal.yaml	- image: {{ .Values.crystal.image }}:{{ .Values.version }}
  nodejs.yaml	- image: {{ .Values.nodejs.image }}:{{ .Values.version }}

frontend.yaml, crystal.yaml, nodejs.yaml 파일에 대해서 모두 적용해야 합니다.

템플릿 기본값으로 values.yaml 파일을 생성합니다. 다음 코드을 실행하여 template directives를 기본값으로 채웁니다

cat <<EoF > ~/environment/eksdemo/values.yaml
# Default values for eksdemo.
# This is a YAML-formatted file.
# Declare variables to be passed into your templates.

# Release-wide Values
replicas: 3
version: 'latest'

# Service Specific Values
nodejs:
  image: brentley/ecsdemo-nodejs
crystal:
  image: brentley/ecsdemo-crystal
frontend:
  image: brentley/ecsdemo-frontend
EoF

4. EKSDEMO 차트 배포

실제로 배포하지 않고 차트의 구문과 유효성을 테스트 하기 위해 --dry-run 플래그를 사용하여 검증합니다.

다음 명령은 렌더링 된 템플릿을 빌드하고 출력 합니다.

helm install --debug --dry-run workshop ~/environment/eksdemo

템플릿으로 생성 된 값이 올바른지 확인 합니다.

템플릿을 테스트 했으므로 이제 차트를 배포해 보겠습니다.

helm install workshop ~/environment/eksdemo

이전에 nginx Helm 차트에서 보았던 것과 유사합니다. 명령의 출력에는 다음과 유사한 배포 상태, 개정, namespace 등에 대한 정보가 포함됩니다.

기본 서비스, 포드 및 배포를 검토하려면 다음을 실행 합니다:

kubectl get svc,po,deploy

5. 서비스 테스트

eksdemo 차트가 생성 한 서비스를 테스트하기 위해 차트를 배포 할 때 생성 된 ELB의 엔드포인트 이름을 가져 옵니다.

kubectl get svc ecsdemo-frontend -o jsonpath="{.status.loadBalancer.ingress[*].hostname}"; echo

해당 주소를 복사하여 브라우저의 새 탭에 붙여 넣으십시오. 다음과 유사한 내용이 표시 되어야 합니다.

6. 롤백

배포 중에 실수가 발생하면 Helm을 사용하여 쉽게 실행을 취소 하거나 이전에 배포한 버전으로 “롤백” 할 수 있습니다.

values.yaml을 열고 nodejs.image 아래의 image : brentley/ecsdemo-nodejs-non-existing으로 수정 합니다. 이 이미지는 존재하지 않으므로 배포가 중단 될 것입니다. 업데이트 된 데모 애플리케이션 차트를 배포합니다.

helm upgrade workshop ~/environment/eksdemo

롤링 업그레이드는 새 이미지로 새 nodejs 파드를 만드는 것으로 시작 됩니다. 새로운 ecsdemo-nodejs 파드는 존재하지 않는 이미지를 가져 오지 못합니다. kubectl get pods를 실행하여 ImagePullBackOff 오류를 확인합니다.

kubectl get pods

helm status workshop을 실행하여 LAST DEPLOYED 타임 스탬프를 확인 합니다.

helm status workshop

이것은helm history workshop의 마지막 항목과 일치해야 합니다.

helm history workshop

실패한 업그레이드에 대해서 이전 애플리케이션 버전으로 롤백합니다.(모든 버전으로 롤백 가능함)

# rollback to the 1st revision
helm rollback workshop 1

다음을 사용하여 workshop 릴리스 상태를 확인 합니다:

helm status workshop

오류가 사라 졌는지 확인 합니다.