Kubernetes

Deploy a Pinot cluster on Kubernetes using Helm.

Outcome

Deploy a production-ready Pinot cluster on Kubernetes with Helm charts.

The examples in this guide are sample configurations for reference. For production deployments, customize settings as needed -- especially security features like TLS and authentication.

Prerequisites

• A running Kubernetes cluster. Options include:

  • Docker Desktop with Kubernetes enabled

  • Minikube -- start with sufficient resources: minikube start --vm=true --cpus=4 --memory=8g --disk-size=50g

  • A managed cloud cluster -- see Managed Kubernetes for AWS, GCP, and Azure setup guides

• Helm 3

• kubectl

Steps

1. Add the Pinot Helm repository

helm repo add pinot https://raw.githubusercontent.com/apache/pinot/master/helm

2. Create a namespace

kubectl create ns pinot-quickstart

3. Install Pinot

Helm with pre-packaged chart

helm install pinot pinot/pinot \
    -n pinot-quickstart \
    --set cluster.name=pinot \
    --set server.replicaCount=2

StorageClass: Specify the StorageClass for your cloud vendor. Use block storage only -- do not mount blob stores (S3, GCS, AzureFile) as the data-serving file system.

• AWS: gp2

• GCP: pd-ssd or standard

• Azure: AzureDisk

• Docker Desktop: hostpath

Helm from Git repo

Verify

Check the deployment status:

kubectl get all -n pinot-quickstart

All pods should reach Running status. You can port-forward the Controller to access the UI:

kubectl port-forward service/pinot-controller 9000:9000 -n pinot-quickstart

Then open http://localhost:9000.

Loading data

For stream ingestion on Kubernetes, see the Kubernetes stream ingestion guide. For batch data loading and table creation, continue with the onboarding path below.

Deleting the cluster

To remove Pinot from your cluster:

kubectl delete ns pinot-quickstart

Next step

Your cluster is running. Continue to First table and schema to load data.