diff --git a/charts/keycloak/BUILD-README.md b/charts/keycloak/BUILD-README.md new file mode 100644 index 0000000..3854e29 --- /dev/null +++ b/charts/keycloak/BUILD-README.md @@ -0,0 +1,79 @@ +# keycloak 버전 갱신 가이드 + +## 1. git 작업 환경 구성 + +- 서비스 카탈로그 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을 제외한 파일 삭제. + ``` sh + # chart 디렉토리로 이동 + cd ~/service-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 차트 다운로드 + ``` sh + # charts 디렉토리로 이동 + cd ~/service-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 +```