propagit

Cascading multi-server git deployment.

example

First start up a hub server to listen for git deploys:

$ propagit hub --port=6000 --secret=beepboop
control service listening on :6000
git service listening on :6001

then spin up as many drones as necessary on other machines with the command to run on deployment for each type of service:

$ propagit drone --hub=hubhost:6000 --secret=beepboop

Now you can git push to the hub and the drones will git fetch from the hub. Just do:

$ cd ~/projects/somerepo
$ git push http://hubhost:6001/somerepo master

First deploy the code to a fresh deploy directory for the given repo name and commit hash:

$ propagit deploy --hub=hubhost:6000 --secret=beepboop \
  somerepo ed56c6e85731d412fe22cf437cb63130afc34b07

then spawn processes for that deployment:

$ propagit spawn --hub=hubhost:6000 --secret=beepboop \
  somerepo ed56c6e85731d412fe22cf437cb63130afc34b07 \
  -- node server.js 8085

usage

Usage:
  propagit OPTIONS hub

    Create a server to coordinate drones.

    --port       port to listen on
    --secret     password to use
    --basedir    directory to put repositories

  propagit OPTIONS drone

    Listen to the hub for deploy events to execute commands with
    environment variables $REPO and $COMMIT set on each deploy.
 
    --hub        connect to the hub host:port
    --secret     password to use
    --basedir    directory to put repositories and deploys in
  
  propagit OPTIONS deploy REPO COMMIT
  
    Deploy COMMIT to all of the drones listening to the hub.

    --hub        connect to the hub host:port
    --secret     password to use
  
  propagit OPTIONS spawn REPO COMMIT [COMMAND...]
  
    Run COMMAND on all the drones specified by OPTIONS.
    $PROCESS_ID and $DRONE_ID will be set for every spawned process.
    Note that $PROCESS_ID is not the system PID value.

  propagit OPTIONS ps
  
    List all the running processes on all the drones.

methods

var propagit = require('propagit')

var p = propagit(opts)

Create a new propagit object with opts:

• secret - authenticate with this passphrase
• hub - if specified, connect to this hub

p.drone()

Register with the connected hub as a drone.

p.listen(controlPort, gitPort)

Create a new hub on controlPort and start a git http server on gitPort.

p.use(fn)

Modify the dnode server or client service with fn(service).

In server mode the fn also gets a conn object: fn(service, conn).

install

With npm do:

npm install -g propagit