service-catalog/manifests/helm/keycloak/18.4.0/BUILD-README.md

keycloak 버전 갱신 가이드

1. git 작업 환경 구성

• DIP 카탈로그 git 다운로드

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

• 작업 브랜치로 체크아웃

$ git checkout -b update-keycloak/18.4.0

2. helm chart 업데이트

* keycloak 차트 변경 시 참고

• 현재 keycloak 배포시 codecentric의 차트를 사용하고 있지만 17.0.1 이상의 버전은 제공하고 있지 않아 bitnami 차트로 변경이 필요하다.

1) 차트 버전 변경

• BUILD-README.md, CUSTOM-README.md, custom-values.yaml을 제외한 파일 삭제.

  # chart 디렉토리로 이동
  cd ~/dip-catalog/charts/keycloak
  
  # 파일 삭제 전 삭제할 파일 목록 확인
  find . -mindepth 1 \( -name "CUSTOM-README.md" -o -name "BUILD-README.md"  -o -name "custom-values.yaml" \) -prune -o -print
  
  # 파일 삭제
  find . -mindepth 1 \( -name "CUSTOM-README.md" -o -name "BUILD-README.md"  -o -name "custom-values.yaml" \) -prune -o -exec rm -rf {} +
  

• codecentric/keycloak 차트 다운로드

  # charts 디렉토리로 이동
  cd ~/dip-catalog/charts
  
  # helm repo 추가
  helm repo add keycloak https://codecentric.github.io/helm-charts
  helm repo update
  
  # helm 차트 
  helm pull keycloak/keycloak --version="18.4.0"
  
  # 차트 변경
  tar xzvf keycloak-*.tgz
  
  # 필요 없는 파일 삭제
  rm keycloak-*.tgz
  rm keycloak/.helmignore keycloak/.bumpversion.cfg
  

3. git push 및 tag 추가

• 갱신작업 진행후 commit

$ git add .
$ git commit -m "update keycloak/18.4.0"

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

$ git checkout main
$ git merge update-keycloak/18.4.0

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

$ git push -u origin main
$ git branch -d update-keycloak/18.4.0

• git tag 추가 후 push

$ git tag keycloak/18.4.0
$ git push origin keycloak/18.4.0

4. 차트 버전 정보

• keycloak/18.4.0
  • 서비스 배포를 위하여 custom-values.yam에 정의하였다.
  • 차트의 빌드 방법과 배포 방법을 BUILD-README.md, CUSTOM-README.md 문서에 작성하였다.