service-catalog/charts/rancher/BUILD-README.md

Rancher 버전 갱신 가이드

1. git 작업 환경 구성

• 서비스 카탈로그 git 다운로드

$ git clone https://github.com/paasup/service-catalog.git

• 작업 브랜치로 체크아웃

$ git checkout -b update-rancher/2.9.1

2. helm 차트 버전 업데이트

1) 차트 버전 변경

• rancher 차트에 추가한 파일을 제외한 나미지 파일을 삭제한다.

  • 삭제 제외 파일,디렉토리 목록

    • BUILD-README.md

    • CUSTOM-README.md

    • custom-values.yaml

    • templates/preinstallHook/*

  • 삭제 명령어.

  # chart 디렉토리로 이동
  cd ~/service-catalog/charts/rancher
  
  # 파일 삭제 전 삭제할 파일 목록 확인
  find . -type f -not \( -name "CUSTOM-README.md" -o -name "BUILD-README.md" -o -name "custom-values.yaml" -o -path "*/templates/preinstallHook/*" -o -path "*/templates/postdeleteHook/*" \)
  
  # 파일 삭제
  find . -type f -not \( -name "CUSTOM-README.md" -o -name "BUILD-README.md" -o -name "custom-values.yaml" -o -path "*/templates/preinstallHook/*" -o -path "*/templates/postdeleteHook/*" \) -delete
  

• 변경할 rancher 버전의 차트를 다운로드

  # charts 디렉토리로 이동
  cd ~/service-catalog/charts
  
  # helm repo 추가
  helm repo add rancher-latest https://releases.rancher.com/server-charts/latest
  helm repo update
  
  # helm 차트 
  helm pull rancher-latest/rancher --version="2.9.1"
  
  # 차트 변경
  tar xzvf rancher*.tgz
  
  # 필요 없는 파일 삭제
  rm rancher-*.tgz
  

3. git push 및 tag 추가

• 갱신작업 진행후 commit

$ git add .
$ git commit -m "update rancher/2.9.1"

• main 브랜치에 체크아웃 후 merge

$ git checkout main
$ git merge update-rancher/2.9.1

• git에 push 후 작업 브랜치 삭제

$ git push -u origin main
$ git branch -d update-rancher/2.9.1

• git tag 추가 후 push

$ git tag rancher/2.9.1
$ git push origin rancher/2.9.1

4. 차트 버전 정보

• rancher/2.9.1
  • 서비스 배포를 위하여 custom-values.yam에 정의하였다.
  • 차트의 빌드 방법과 배포 방법을 BUILD-README.md, CUSTOM-README.md 문서에 작성하였다.
• rancher/2.9.1-1
  • 사설 인증서 사용시 전처리를 위한 Helm preinstall Hook을 추가하였다.
  • 변경 사항을 BUILD-README.md, CUSTOM-README.md 문서에 반영하였다.
• rancher/2.9.1-2
  • Helm preinstall Hook으로 생성된 자원을 삭제하기 위해 Helm postdelete Hook을 추가하였다.
  • 변경 사항을 BUILD-README.md 문서에 반영하였다.