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