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 pdbuild.sh setup
  5. Boot local testing VM pdbuild.sh up
  6. Install instance dependencies pdbuild.sh install_deps
  7. Build the tools to go into testing VM pdbuild.sh build
  8. Push tools into VM pdbuild.sh install (NOTE: sometimes this fails, please check Known Issues)
  9. Check the installation pdbuild.sh 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

Result:
...
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.