service-catalog/manifests/helm/kafka-ui/1.5.1.x/BUILD-README.md

Kafka-UI 버전 갱신 가이드

1. git 작업 환경 구성

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

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

• 작업 브랜치로 체크아웃

$ git checkout -b update-kafka-ui/1.5.1

2. helm chart 업데이트

1) 차트 버전 변경

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

  # chart 디렉토리로 이동
  cd ~/service-catalog/charts/kafka-ui
  
  # 파일 삭제 전 삭제할 파일 목록 확인
  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 {} +
  

• kafbat/kafka-ui 차트 다운로드

  # charts 디렉토리로 이동
  cd ~/service-catalog/charts
  
  # helm repo 추가
  helm repo add kafka-ui https://kafbat.github.io/helm-charts
  helm repo update
  
  # helm 차트 다운로드
  helm pull kafka-ui/kafka-ui --version="1.5.1"
  
  # 차트 변경
  tar xzvf kafka-ui*.tgz
  
  # 필요 없는 파일 삭제
  rm kafka-ui-*.tgz
  

2) 차트 수정 사항 반영

• Kafbat UI (구 kafka-ui) 차트는 기본적으로 별도의 수정 사항 없이 사용 가능합니다.
• custom-values.yaml에서 Kafka 클러스터 연결 정보와 인증 설정을 조정하여 사용합니다.

3. git push 및 tag 추가

• 갱신작업 진행후 commit

$ git add .
$ git commit -m "update kafka-ui/1.5.1"

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

$ git checkout main
$ git merge update-kafka-ui/1.5.1

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

$ git push -u origin main
$ git branch -d update-kafka-ui/1.5.1

• git tag 추가 후 push

$ git tag kafka-ui/1.5.1
$ git push origin kafka-ui/1.5.1

4. 차트 버전 정보

• kafka-ui/1.5.1
  • Kafbat UI v1.3.0 기반 (구 kafka-ui)
  • Apache Kafka 클러스터 모니터링 및 관리를 위한 웹 UI
  • 다중 클러스터 관리 지원
  • SASL, SSL 등 다양한 인증 방식 지원
  • Schema Registry, Kafka Connect 지원
  • OAuth 2.0 인증 지원 (GitHub/GitLab/Google)
  • 역할 기반 접근 제어 (RBAC) 지원
  • 데이터 마스킹 기능 지원
  • 서비스 배포를 위하여 custom-values.yaml에 정의
  • 차트의 빌드 방법과 배포 방법을 BUILD-README.md, CUSTOM-README.md 문서에 작성