Running Pravega Locally¶
Running locally allows you to get started using pravega very quickly. Most of the options use the standalone mode which is suitable for most development and testing.
All of the options for running locally start the required prerequisites so you can get started right away.
First you need to have the Pravega source code checked out:
git clone https://github.com/pravega/pravega.git cd pravega
This one command will download dependencies, compile pravega and start the standalone deployment.
From Installation Package¶
Download the Pravega release from the github releases page. The tarball and zip are identical. Instructions are provided using tar but the same steps work with the zip file.
tar xfvz pravega-0.1.0.tgz
Run pravega standalone:
From Docker Container¶
This will download and run Pravega from the container image on docker hub.
Note, you must replace the
<ip> with the IP of your machine. This is so that you can connect to Pravega from your local system. Optionally you can replace
latest with the version of Pravega your desire
docker run -it -e HOST_IP=<ip> -p 9090:9090 -p 12345:12345 pravega/pravega:latest standalone
Docker Compose (Distributed Mode)¶
Unlike other options for running locally, the docker compose option runs a full Pravega install in distributed mode. It contains containers for running Zookeeper, Bookkeeper and HDFS so Pravega operates as if it would in production. This is as easy to get started with as the standalone option but requires additional resources available.
To use this you need to have Docker
1.12 or later.
Download the docker-compose.yml from github. For example:
You need to set the IP address of your local machine as the value of HOST_IP in the following command. To run:
HOST_IP=18.104.22.168 docker-compose up
Clients can then connect to the controller at