Getting Started¶

To get a trivial cluster up and running on a machine, the compose file can be used.

Update etc hosts to interact wih nginx¶

Add the following lines to /etc/hosts

127.0.0.1   drove.local
127.0.0.1   testapp.local

wget https://raw.githubusercontent.com/PhonePe/drove-orchestrator/master/compose/compose.yaml

cd compose
docker-compose up

This will start zookeeper,drove controller, executor and nginx/drove-gateway. The following ports are used:

Drove credentials would be admin/admin and guest/guest for read-write and read-only permissions respectively.

You should be able to access the UI at http://drove.local:7000

Install the CLI for drove

pip install drove-cli

Put the following in ${HOME}/.drove

[local]
endpoint = http://drove.local:4000
username = admin
password = admin

Get the sample app spec:

wget https://raw.githubusercontent.com/PhonePe/drove-cli/master/sample/test_app.json

Now deploy the app.

drove -c local apps create test_app.json

drove -c local apps scale TEST_APP-1 1 -w

This would expose the app as testapp.local. Endpoint would be: http://testapp.local:7000.

You can test the app by running the following commands:

curl http://testapp.local:7000/
curl http://testapp.local:7000/files/drove.txt

drove -c local apps scale TEST_APP-1 0 -w
drove -c local apps destroy TEST_APP-1

Code is hosted on github.

Cloning everything:

git clone git@github.com:PhonePe/drove-orchestrator.git
git submodule init
git submodule update