gosuv

golang port of python-supervisor

Program not implement

Not done yet.

God damn, maybe need to delete all the code and start from scrach again.

So need redesign, bye the old code

GET /api/procs
GET /api/procs/:name

PUT /api/procs/:name

	- action: <restart|start|stop>

POST /api/procs

DELETE /api/procs/:name

Features

• Log view
• Github webhook

TODO

• web control page
• cli remove (DONE)

Requirements

Go version at least 1.5+

Install

go get -v github.com/codeskyblue/gosuv

Usage

$ gosuv add --name timetest -- bash -c "while true; do date; sleep 1; done"
program "timetest" has been added.

$ gosuv status
NAME		STATUS
timetest	running

$ gosuv stop timetest
program "timetest" stopped

$ gosuv tail -n 2 timetest
line 1
line 2
line ...

$ gosuv remove timetest
# remove program which named timetest

# see more usage
$ gosuv help

Config(TODO)

~/.gosuv/config.yml content example

---
listen:
  web: 0.0.0.0:9090
  rpc: 127.0.0.1:54637

All process save to ~/.gosuv/procs.yml

Web page will be look like just a table, have command Start|Stop|Restart, and got state

State

Only 4 states. ref

Plugin Design

Current plugins:

• tailf

All command plugin will store in $HOME/.gosuv/cmdplugin, gosuv will treat this plugin as a subcommand.

for example:

$HOME/.gosuv/cmdplugin/ --.
	|- showpid/
		|- run

There is a directory showpid

When run gosuv showpid, file run will be called.

RPC Design

I decide to use grpc in 2015-09-05

https://github.com/grpc/grpc-go https://github.com/golang/protobuf

go get -u -v github.com/golang/protobuf/{proto,protoc-gen-go}
pbrpc/codegen.sh

Need protoc 3.0 http://www.cnblogs.com/yuhan-TB/p/4629362.html

Do not use brew install protobuf, this will only install protoc 2.6

Design

Has a folder .gosuv under $HOME path.

Here is the folder structure

$HOME/.gosuv
	|-- gosuv.json
	|-- logs/
		  |-- program1.log
	      |-- program2.log

For first run gosuv command, will run a golang server.

Server port default 17422 or from env defined GOSUV_SERVER_PORT.

When server get TERM signal, all processes spwaned by srever will be killed.

How to add program to gosuv

Eg, current folder is in /tmp/hello

gosuv add --name "program1" -- ./program1 1888

Will add a record to $HOME/.gosuv/programs.json

{
	"name": "program1",
	"command": ["./program1", "1888"],
	"directory": "/tmp/hello",
	"environ": [],
}

Show status

$ gosuv status
program1		RUNNING

Stop program, ex: "program1"

$ gosuv stop program1
program1 stopped

Use libs

• https://github.com/ahmetalpbalkan/govvv

LICENSE

MIT