nimbus/readme.md

simple cloud deployment for node apps, follows convention, no lock-in

Prereqs:
  - node.js >= 0.6 (with npm)
  - git
  - Foreman
  - Make
  - an account on heroku, joyent, azure, linode, or rackspace

What the user creates:
  - package.json
  - app code
  - git repository
  - .gitignore
  - Procfile
  - nimbus.json

What the user does:

  $ nimbus list

    lists all the targets defined in the nimbus.json file

  $ nimbus provision `serviceName`

    provisions the service at `serviceName`

    - root: add keys to the remote system
    - root: upgrade basic systems (build chain, etc)
    - root: create user for the service
    - local: render scripts for the service
    - local: copy rendered scripts to the remote machine
    - serviceuser: run the remote scripts

  $ nimbus update `serviceName`

    updates the service at `serviceName`
    (for example, updating config files, environment settings...)
    (should be non-destructive... no risk of losing user data)
    (should be fast & not require a restart)

  $ nimbus deploy `serviceName` [branch|hash]

    deploys the git branch or hash specified to `serviceName`

    - system does a git push to remote
    - post-receive hook on remote copies the checked out codebase into a versions/{{gitHash}} directory
    - post-receive hook then runs npm install
    - if npm install goes okay, post-receive hook does an rsync between the new version and the /current directory running the app
    - post-receive hook restarts foreman

TODO:
  - set NODE_ENV to production via .env.json