Add BUILD-README.md

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
+```