Getting Started

This will quickly take you through the process of bringing up a Hello World chute in a virtual machine on your computer.

NOTE: As of release 0.1, pdbuild is built around using Ubuntu. We will eliminate this requirement soon, work arounds can be found at What if I don’t have Ubuntu?.

Environment setup

  1. Prerequisites:
    • Packages: Python 2.7, python-pip, python-dev, libffi-dev, libssl-dev
    • PyPI: pex
    • When you install build tools you may have to run: sudo pip install pypubsub --allow-external pypubsub
  2. Install our build tools (pip install pdtools).
  3. Clone our instance tools.
  4. Setup instance tools setup
  5. Boot local testing VM up
  6. Install instance dependencies install_deps
  7. Build the tools to go into testing VM build
  8. Push tools into VM install (NOTE: sometimes this fails, please check Known Issues)
  9. Check the installation check

Installing chutes

First you must register an account from our CLI: paradrop register. This will setup a private key on your computer which allows you to access our platform.

Install hello-world chute:

cd <apps-repo>/hello-world
paradrop chute install localhost 9999 ./config.yaml

Chute hello-world create success

As a simple use case, hello-world starts an nginx server in the chute. To access this, visit localhost:9000 in any web browser, you should see:

Hello World from Paradrop!

Running paradrop chute stop localhost 9999 hello-world will stop the chute, if you refresh the webpage, you should no longer see the Hello World message.