Helm 차트 참조

Helm 차트 참조 (Helm Chart Reference)

Apache Pinot 공식 Helm 차트의 설정값(values) 참조를 안내해요.

출처: 문서

본문

개요 (Overview)

Pinot Helm 차트는 controller, broker, server, minion 컴포넌트를 Kubernetes에 배포하기 위한 설정값을 제공해요. values.yaml에서 이미지, 복제본 수, 리소스, 영구 볼륨, 서비스, 그리고 각 컴포넌트의 Pinot 구성 오버라이드를 지정할 수 있어요.

공통 설정 (Common settings)

차트의 상위 레벨 설정으로 각 컴포넌트에 공통 적용돼요:

이미지 — image.repository, image.tag, imagePullPolicy로 사용할 Pinot 이미지를 지정해요.
replicaCount — 각 컴포넌트의 파드 복제본 수.
resources — CPU/메모리 요청(request)과 제한(limit).
service — 각 컴포넌트의 서비스 타입, 포트, 어노테이션.
persistence / storage — 세그먼트 저장용 영구 볼륨(PVC) 또는 클라우드 스토리지 설정.

컨트롤러 (Controller)

컨트롤러 관련 설정값:

controller.replicaCount — 컨트롤러 파드 수.
controller.resources / controller.jvmOpts — 리소스와 JVM 옵션.
controller.service — 컨트롤러 서비스(포트 9000).
controller.config / controller.extraConfigs — 컨트롤러 Pinot 구성 오버라이드(예: controller.zk.str, 데이터 디렉토리).
controller.persistence — 컨트롤러 데이터 저장.

브로커 (Broker)

브로커 관련 설정값:

broker.replicaCount, broker.resources, broker.jvmOpts.
broker.service — 브로커 서비스(쿼리 포트 8099).
broker.config / broker.extraConfigs — 브로커 Pinot 구성 오버라이드.
브로커는 상태를 저장하지 않으므로 영구 볼륨 없이 운영돼요.

서버 (Server)

서버 관련 설정값:

server.replicaCount, server.resources, server.jvmOpts.
server.service — 서버 서비스(포트 8098).
server.persistence — 세그먼트 데이터용 영구 볼륨. MMAP 모드의 서버는 충분한 디스크·메모리가 필요해요.
server.config / server.extraConfigs — 서버 Pinot 구성 오버라이드(pinot.server.instance.dataDir 등).

미니언 (Minion)

미니언 관련 설정값:

minion.replicaCount, minion.resources, minion.jvmOpts.
minion.config / minion.extraConfigs.
Minion 작업(merge/rollup 등)을 사용하면 활성화해요.

구성 주입 (Configuration injection)

ConfigMap / extraConfigs — 각 컴포넌트의 pinot-*.conf 설정을 ConfigMap으로 주입하거나 extraConfigs로 오버라이드할 수 있어요.
시크릿 (secrets) — 자격 증명 등 민감한 값은 Kubernetes Secret으로 주입해요.
환경 변수 — env를 통해 컨테이너 환경 변수를 추가할 수 있어요.

모범 사례 (Best practices)

각 컴포넌트에 리소스 요청·제한을 명시하고 JVM 힙을 워크로드에 맞게 설정하세요.
server와 controller에는 영구 스토리지를, broker에는 상태가 없으므로 필요에 따라 설정하세요.
구성 오버라이드는 문서의 Pinot 구성 참조와 대조해 올바른 키를 사용하세요.