Up and Running development environment built with parse-server and docker.

Install Docker and run docker-compose, wait for some magic to happen (requires internet) and check 0.0.0.0:8080.

Spoiler Alert: the demo is at paddock.tech.

• Install
• Start
  • Use the paddock UI
  • Use the parse-server API
  • Access to MongoDB
  • Configuration
    • Mailgun (email verification)
    • Twitter (social login)
  • Features
    • Email verification
    • Oauth login (Twitter)
    • ACL
    • Cloud code
• Deploy
  • Docker Cloud
  • HYPER_
  • now
  • Demo
• FAQ
• Miscellaneous
  • Other useful docker-compose commands

To get started with paddock you're only going to need Docker installed:

• Install 'Docker for Mac', 'Docker for Windows' or 'Docker for Linux'

• Run Docker

In order to start the parse-server with Docker open your terminal and run docker-compose:

# Create and start containers (get easy access to the logs)
docker-compose up

# or create and start containers in Detached mode (`-d` runs containers in the background)
docker-compose up -d

This command is going to download two images: alpine-node and alpine-mongo, and it's going to start three Docker containers (Front-end, Back-end and Database).

Node.js containers will start with the $NODE_ENV environment variables set in .env and server/.env.

npm install in Node.js containers will be automatically executed from the prestart scripts. Wait for the installs to finish and you'll be ready to go.

Open http://0.0.0.0:8080/

Excerpt from parse-server

Saving your first object (POST)

curl -X POST \
  -H "X-Parse-Application-Id: APPLICATION_ID" \
  -H "Content-Type: application/json" \
  -d '{"score":1337,"playerName":"Sean Plott","cheatMode":false}' \
  http://localhost:1337/parse/classes/GameScore

Retrieving your collection (GET)

$ curl -X GET \
  -H "X-Parse-Application-Id: APPLICATION_ID" \
  http://localhost:1337/parse/classes/GameScore

Need a GUI? Check Robomongo

paddock comes bundled with some of the main features from parse-server. By default we enabled oauth login (with Twitter, so far) in server/config/parse.js. Email verification is optional. Both these features need API keys (if you want to keep them).

Getting started with Mailgun is free and takes 57 seconds. http://www.mailgun.com/

(Walkthrough TBD)

Sign in with your Twitter Account to create and maintain Twitter Apps. https://apps.twitter.com/

(Walkthrough TBD)

(TBD)

(TBD)

(TBD)

(TBD)

Current deploy strategy is based onto a Dockerfile: Dockerfile.deploy.

paddock itself is built and deployed with Docker Cloud, based onto the Dockerfile.deploy configuration.

https://www.hyper.sh/

hyper compose up --file=hyper-deploy.yml -d

(TBD)

(TBD) https://now.sh

You can check the demo at paddock.tech

• Is this production ready?

No

# List containers
docker-compose ps

# View output from containers
docker-compose logs

# Stop and remove containers, networks, images, and volumes
docker-compose down

# Build or rebuild services
docker-compose build