Pinot 클러스터 업그레이드
Pinot 클러스터 업그레이드 (Upgrading Pinot Cluster)
Apache Pinot 클러스터를 새 버전으로 업그레이드하는 절차를 안내해요.
출처: 문서
본문
개요 (Overview)
Pinot 업그레이드는 다운타임을 최소화하면서 controller, broker, server, minion을 순차적으로 새 버전으로 교체하는 절차를 포함해요. 버전 간 호환성과 데이터 안전을 고려해야 해요.
업그레이드 순서 (Upgrade order)
일반적으로 다음 순서로 업그레이드해요:
- 민니언 (Minion) — 먼저 업그레이드해 작업 실행에 문제가 없도록 해요.
- 컨트롤러 (Controller) — 관리 평면을 업그레이드해요.
- 브로커 (Broker) — 쿼리 평면을 업그레이드해요.
- 서버 (Server) — 마지막으로 데이터 노드를 업그레이드해요.
순서는 배포 환경과 요구사항에 따라 다를 수 있어요 (예: Helm/K8s에서는 롤링 업그레이드가 자동으로 이뤄져요).
다운타임 최소화 (Minimizing downtime)
- 롤링 업그레이드 — 각 컴포넌트를 한 번에 일부 파드/인스턴스만 교체해 가용성을 유지해요.
- 복제 유지 — 서버 업그레이드 중에도 레플리카가 서빙하도록
replication을 2 이상으로 둬요. - 실시간 소비 — 실시간 테이블의 소비가 업그레이드 중 유지되도록 주의해요.
업그레이드 전 점검 (Pre-upgrade checklist)
- Upgrade Notes에서 대상 버전의 주의사항을 확인하세요.
- 딥 스토어와 ZooKeeper의 백업이 있는지 확인하세요.
- 클러스터 상태(Ideal/External View)가 건강한지 확인하세요.
업그레이드 후 점검 (Post-upgrade verification)
- 모든 컴포넌트가 새 버전으로 기동했는지 확인하세요.
- 테이블 세그먼트가 ONLINE이고 쿼리가 정상 동작하는지 검증하세요.
- 실시간 소비 래그가 정상 범위인지 확인하세요.