Running Pinot in Docker

Search…
This quick start guide will show you how to run a Pinot cluster using Docker.
This is a quickstart guide that will show you how to quickly start an example recipe in a standalone instance and is meant for learning. To run Pinot in cluster mode, please take a look at Manual cluster setup.
Prerequisites
Install Docker​
You can also try Kubernetes quick start if you already have a local minikube cluster installed or Docker Kubernetes setup.
If running locally, please ensure your docker cluster has enough resources, below is a sample config.
We'll be using our docker image apachepinot/pinot:latest to run this quick start, which does the following:
Sets up the Pinot cluster
Creates a sample table and loads sample data
The following quick-start scripts are available 
Batch example
Streaming example
Hybrid example
Before running the scripts, create an isolated bridge network pinot-demo in docker. This will allow all docker containers to easily communicate with each other. You can create the network using the following command - 
1
docker network create -d bridge pinot-demo
Copied!
Batch example
In this example we demonstrate how to do batch processing with Pinot.
Starts Pinot deployment by starting
Apache Zookeeper
Pinot Controller
Pinot Broker
Pinot Server
Creates a demo table
baseballStats
Launches a standalone data ingestion job
Builds one Pinot segment for a given CSV data file for table baseballStats
Pushes the built segment to the Pinot controller
Issues sample queries to Pinot
1
docker run \
2
    --network=pinot-demo \
3
    --name pinot-quickstart \
4
    -p 9000:9000 \
5
    -d apachepinot/pinot:latest QuickStart \
6
    -type batch
Copied!
Once the Docker container is running, you can view the logs by running the following command.
1
docker logs pinot-quickstart -f
Copied!
That's it! We've spun up a Pinot cluster. 
It may take a while for all the Pinot components to start and for the sample data to be loaded. 
Use the below command to check the status in the container logs.
1
docker logs pinot-quickstart -f
Copied!
Your cluster is ready once you see the cluster setup completion messages and sample queries, as demonstrated below.
Cluster Setup Completion Example 
You can head over to Exploring Pinot to check out the data in the baseballStats table.
Streaming example
In this example we demonstrate how to do stream processing with Pinot.
Starts Pinot deployment by starting
Apache Kafka
Apache Zookeeper
Pinot Controller
Pinot Broker
Pinot Server
Creates a demo table
meetupRsvp
Launches a meetup stream
Publishes data to a Kafka topic meetupRSVPEvents to be subscribed to by Pinot
Issues sample queries to Pinot
1
# stop previous container, if any, or use different network
2
docker run \
3
    --network=pinot-demo \
4
    --name pinot-quickstart \
5
    -p 9000:9000 \
6
    -d apachepinot/pinot:latest QuickStart \
7
    -type stream
Copied!
Once the cluster is up, you can head over to  Exploring Pinot to check out the data in the meetupRSVPEvents table.
Hybrid example
In this example we demonstrate how to do hybrid stream and batch processing with Pinot.
1.
Starts Pinot deployment by starting
Apache Kafka
Apache Zookeeper
Pinot Controller
Pinot Broker
Pinot Server
2.
Creates a demo table
airlineStats
3.
Launches a standalone data ingestion job
Builds Pinot segments under a given directory of Avro files for table airlineStats
Pushes built segments to Pinot controller
4.
Launches a stream of flights stats
5.
Publishes data to a Kafka topic airlineStatsEvents to be subscribed to by Pinot
6.
Issues sample queries to Pinot 
1
# stop previous container, if any, or use different network
2
docker run \
3
    --network=pinot-demo \
4
    --name pinot-quickstart \
5
    -p 9000:9000 \
6
    -d apachepinot/pinot:latest QuickStart \
7
    -type hybrid
Copied!
Once the cluster is up, you can head over to  Exploring Pinot to check out the data in the airlineStats table.
Running Pinot locally
Running Pinot in Kubernetes
Last modified 5mo ago
Copy link
Contents
Batch example
Streaming example
Hybrid example