- Introduction
- Prerequisites
- Video
- Check the Code Out
- Quick Install Using Makefile
- Step by Step Install
PPnet provides a simple way to get your own social network site up and running in a matter of minutes. It leverages Docker to create containers and Giant Swarm to run the containers in the cloud.
- An OSX based machine.
- A Giant Swarm account.
- A function install of boot2docker.
Here's a great video where I'm out-of-breath from being so excited about being over in Cologne, Germany. Ignore the fact I'm sweating a bit from running up the stairs.
You can checkout the code by doing the following:
git clone hhttps://github.com/pixelpark/ppnet.git
Change into the server sub-directory:
cd ppnet/server
If you just want to get to it, just swarm it up!
$ make swarm-up
Your social site will be available from:
http://ppnet-username.gigantic.io/
You'll need to replace 'username' with your Giant Swarm username, which can be found by doing a:
swarm user
You can reference the Makefile and the swarm.json file for details on the deployment.
Let's start by testing the application locally:
make run-local
Once all the container layers have been downloaded, you should be able to access the application locally:
http://192.168.59.103:8000/
Just type in something like '@kordless' to login. The application will remember your browser when you come back. Magic.
You can do a ctrl-c to kill the application. In order to stop the CouchDB server, you'll need to issue stop commands. The Makefile will do this for you:
make docker-stop-couchdb
That command will take a few seconds to run. If you want do do it manually:
docker stop couchdb
docker delete couchdb
Now let's deploy the app to Giant Swarm's magical reality field. As usual, it's trivial:
$ make swarm-up
Again, once the images have been deployed, you can access the app from:
http://ppnet-kord.gigantic.io/
Obviously replace the 'kord' in that URL with your Giant Swarm username. If you want a different subdomain for your URL, just edit the Makefile and change it toward the top.
Just type in something like '@kordless' to login. The application will remember your browser when you come back.
Magic.