nexus

nexus - remote program installation and control (work in progress/proof of concept)

     _______________________________
    /    ___  ___  _ _  _ _  ___    \
    |   |   || -_||_'_|| | ||_ -|   |
    |   |_|_||___||_,_||___||___|   |
    \_____________________________  / ____       ___
                                  \| / .  \  .-´/   \`-.
                                     \____ \/   \___/   \__
                                          \_`---´___`---´-´
                                           /../..\ /..\..\

• nexus is basically built upon npm and dnode and inspired by forever.
• nexus provides a cli and a dnode-interface to install, uninstall, start, stop and observe local and remote programs (npm packages).
• running programs are require('child_process').spawn'ed child-processes of monitor-servers (dnode-clients).
• all the config, logs and programs live in ~/.nexus by default.
• nexus is still super-alpha.

install

• install node
• install npm
• npm install nexus

cli

nexus [-r <remote>] [<command> [<options>]]

commands:

    version   .. print version-number
    config    .. get/set config
    ls        .. list installed packages
    install   .. install packages
    uninstall .. uninstall packages
    ps        .. list of current running (and crashed) programs
    start     .. start a program
    restart   .. restart a running (or max crashed) program
    stop      .. stop a running program
    stopall   .. stop all running programs
    logs      .. access log-files
    cleanlogs .. remove old log-files (of not-running programs)
    subscribe .. subscribe to events
    server    .. start/stop/restart the nexus-server
    help      .. try `nexus help <command>` for more info

api

var config = '/path/to/config.js' // or json

var nexus = require('nexus')(config)

function cb(err, data) {console.log(data)}

nexus.version(cb)
nexus.config(cb)
nexus.ls(cb)
nexus.install({package:'helloworld',name:'some-name'},cb)
nexus.uninstall('helloworld',cb)
nexus.ps(cb)
nexus.start({command:'node',script:'/path/to/script'},cb)
nexus.restart('id',cb)            
nexus.stop('id',cb)
nexus.stopall(cb)
nexus.logs({file:'file',lines:20},cb)
nexus.cleanlogs(cb)
nexus.server({cmd:'start',config:'/path/to/config.json'},cb)
nexus.subscribe('*',function(event,data){console.log(event,'→',data)},cb)