업그레이드 노트
업그레이드 노트 (Upgrade Notes)
Apache Pinot 버전별 업그레이드 시 알아야 할 사항을 정리한 문서예요.
출처: 문서
본문
개요 (Overview)
이 페이지는 Pinot을 새 버전으로 업그레이드할 때 주의해야 할 변경 사항, 호환성 이슈, 그리고 업그레이드 절차를 버전별로 정리해요. 업그레이드 전에 현재 버전과 대상 버전 사이의 노트를 반드시 확인해야 해요.
주요 업그레이드 원칙 (Key upgrade principles)
- 호환성 검토 — 대상 버전의 동작 변경(breaking change)이 있는지 확인하고, 필요 시 구성을 함께 조정해요.
- 구성 기본값 변경 — 일부 버전은 구성 기본값이 달라져(예: 메트릭, 로드 모드, 기본 시큐리티) 동작 변화가 생길 수 있어요.
- 기능 추가/변경 — 새 인덱스 타입, 쿼리 기능, 모니터링 지표 등의 변경을 파악해요.
- 업그레이드 절차 — Upgrading Pinot Cluster의 순서(민니언 → 컨트롤러 → 브로커 → 서버)를 따르고, 롤링 업그레이드로 가용성을 유지해요.
버전별 노트 (Version-specific notes)
문서에는 각 대상 버전에 대해 다음 내용이 정리돼 있어요:
- 동작 변경 (Breaking changes) — 기존 동작을 바꾸는 변경과 마이그레이션 방법.
- 새로운 기능 (New features) — 해당 버전에서 추가된 주요 기능.
- 구성 변경 (Configuration changes) — 추가·이름 변경·기본값이 바뀐 구성 키.
- 사전 조치 (Pre-upgrade actions) — 업그레이드 전에 해야 할 작업(스키마/테이블 조정 등).
업그레이드 전 확인 사항
- 대상 버전의 업그레이드 노트를 처음부터 끝까지 확인하세요.
- 딥 스토어와 ZooKeeper 백업을 확보하세요.
- 프로덕션에 적용하기 전에 테스트 환경에서 업그레이드를 검증하세요.