Jesus is a simple-ish process management tool. It's designed to be very light,
while still providing functions enough to be automated if necessary. To that
end, it only runs a single process to monitor all your stuff. It can be exposed
via a unix socket (default) or an actual network interface for automation.
usage: jesus [-h] [-v] {listen,daemon,start,stop,stopall,restart,restartall,check,list} ...Resurrect processes if they dieOptional arguments: -h, --help Show this help message and exit. -v, --version Show program's version number and exit.Actions: {listen,daemon,start,stop,stopall,restart,restartall,check,list}
Environment Variables
jesus will use the JESUS_HOST, JESUS_PORT, JESUS_SOCKET, JESUS_BASE,
JESUS_LOG, and JESUS_STATE environment variables if they are defined. See
below for where they are useful.
Commands
listen
usage: jesus listen [-h] [-H HOST] [-p PORT] [-s SOCKET] [-b BASE_PATH] [-l LOG] [-S STATE]Start jesus listeningOptional arguments: -h, --help Show this help message and exit. -H HOST, --host HOST Host for jesus to listen on -p PORT, --port PORT Port for jesus to listen on -s SOCKET, --socket SOCKET Unix socket for jesus to listen on (only used if host/port are not) -b BASE_PATH, --base-path BASE_PATH Base directory for application logs and other files to go in -l LOG, --log LOG Log file for actions taken and events emitted by jesus -S STATE, --state STATE State file for keeping track of running processes between starts/stops
daemon
usage: jesus daemon [-h] [-H HOST] [-p PORT] [-s SOCKET] [-b BASE_PATH] [-l LOG] [-S STATE]Start jesus listening and daemoniseOptional arguments: -h, --help Show this help message and exit. -H HOST, --host HOST Host for jesus to listen on -p PORT, --port PORT Port for jesus to listen on -s SOCKET, --socket SOCKET Unix socket for jesus to listen on (only used if host/port are not) -b BASE_PATH, --base-path BASE_PATH Base directory for application logs and other files to go in -l LOG, --log LOG Log file for actions taken and events emitted by jesus -S STATE, --state STATE State file for keeping track of running processes between starts/stops
start
usage: jesus start [-h] [-H HOST] [-p PORT] [-s SOCKET] [-n NAME] [-e ENV] [-f {text,json}] ...Start a processPositional arguments: command Command to run and superviseOptional arguments: -h, --help Show this help message and exit. -H HOST, --host HOST Host where server for jesus to connect to is listening -p PORT, --port PORT Port where server for jesus to connect to is listening -s SOCKET, --socket SOCKET Unix socket where server for jesus to connect to is listening (only used if host/port are not) -n NAME, --name NAME -e ENV, --env ENV Environment variables (specified like NAME=VALUE) -f {text,json}, --format {text,json}
stop
usage: jesus stop [-h] [-H HOST] [-p PORT] [-s SOCKET] [-f {text,json}] nameStop a process by namePositional arguments: nameOptional arguments: -h, --help Show this help message and exit. -H HOST, --host HOST Host where server for jesus to connect to is listening -p PORT, --port PORT Port where server for jesus to connect to is listening -s SOCKET, --socket SOCKET Unix socket where server for jesus to connect to is listening (only used if host/port are not) -f {text,json}, --format {text,json}
stopall
usage: jesus stopall [-h] [-H HOST] [-p PORT] [-s SOCKET] [-f {text,json}]Stop all processesOptional arguments: -h, --help Show this help message and exit. -H HOST, --host HOST Host where server for jesus to connect to is listening -p PORT, --port PORT Port where server for jesus to connect to is listening -s SOCKET, --socket SOCKET Unix socket where server for jesus to connect to is listening (only used if host/port are not) -f {text,json}, --format {text,json}
restart
usage: jesus restart [-h] [-H HOST] [-p PORT] [-s SOCKET] [-f {text,json}] nameRestart a process by namePositional arguments: nameOptional arguments: -h, --help Show this help message and exit. -H HOST, --host HOST Host where server for jesus to connect to is listening -p PORT, --port PORT Port where server for jesus to connect to is listening -s SOCKET, --socket SOCKET Unix socket where server for jesus to connect to is listening (only used if host/port are not) -f {text,json}, --format {text,json}
restartall
usage: jesus restartall [-h] [-H HOST] [-p PORT] [-s SOCKET] [-f {text,json}]Restart all processesOptional arguments: -h, --help Show this help message and exit. -H HOST, --host HOST Host where server for jesus to connect to is listening -p PORT, --port PORT Port where server for jesus to connect to is listening -s SOCKET, --socket SOCKET Unix socket where server for jesus to connect to is listening (only used if host/port are not) -f {text,json}, --format {text,json}
check
usage: jesus check [-h] [-H HOST] [-p PORT] [-s SOCKET] [-f {text,json}]Check the status of a processOptional arguments: -h, --help Show this help message and exit. -H HOST, --host HOST Host where server for jesus to connect to is listening -p PORT, --port PORT Port where server for jesus to connect to is listening -s SOCKET, --socket SOCKET Unix socket where server for jesus to connect to is listening (only used if host/port are not) -f {text,json}, --format {text,json}
list
usage: jesus list [-h] [-H HOST] [-p PORT] [-s SOCKET] [-f {text,json}]List all processesOptional arguments: -h, --help Show this help message and exit. -H HOST, --host HOST Host where server for jesus to connect to is listening -p PORT, --port PORT Port where server for jesus to connect to is listening -s SOCKET, --socket SOCKET Unix socket where server for jesus to connect to is listening (only used if host/port are not) -f {text,json}, --format {text,json}