Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/codeskyblue/gosuv
Deprecated!!! Process managerment writtern by golang, inspired by python-supervisor
https://github.com/codeskyblue/gosuv
golang supervisor
Last synced: 22 days ago
JSON representation
Deprecated!!! Process managerment writtern by golang, inspired by python-supervisor
- Host: GitHub
- URL: https://github.com/codeskyblue/gosuv
- Owner: codeskyblue
- License: mit
- Archived: true
- Created: 2015-09-01T14:37:14.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2020-12-07T07:38:10.000Z (about 4 years ago)
- Last Synced: 2024-08-05T17:28:46.144Z (4 months ago)
- Topics: golang, supervisor
- Language: JavaScript
- Homepage:
- Size: 7.59 MB
- Stars: 644
- Watchers: 46
- Forks: 181
- Open Issues: 42
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-hacking-lists - codeskyblue/gosuv - Deprecated!!! Process managerment writtern by golang, inspired by python-supervisor (JavaScript)
README
# gosuv
[](https://travis-ci.org/codeskyblue/gosuv)
[中文README](README_ZH.md) 不是很全，能看懂英文的还是尽量看英文
## current is in beta
Process management writtern by golang, inspired by python-supervisor
## So why write another supervisor?
I have been using python-supervisor for many years and there are something uncomfortable feelings.
1. Log can't contains ANSI color chars
1. The configuration file can add on the web, often forgot some settings.
1. `supervisorctl reload` will cause supervisord restarted
1. Hard to set status change to fatal notifications.
1. No process performance monitor page.
1. Program starts with no common environ, eg, missing HOME and USER variable
1. Kill process default is not group kill which make sub process still running.
1. More... will added when I think of it.
## Features
* [x] Web control page
* [x] Start, Stop, Tail, Reload
* [x] Realtime log
* [x] Add program support
* [x] Edit support
* [x] Delete support
* [x] Memory and CPU monitor
* [ ] Path auto complete
* [x] HTTP Basic auth
* [x] Github webhook
* [ ] Single log page, include search support
* [ ] 中文文档
## Requirements
Go version at least `1.6+`
## Installation
### Binaries
The fastest way is run with. Default install location is `/usr/local/bin`, change env-var `BINDIR` will also change install location.
```
curl https://raw.githubusercontent.com/codeskyblue/gosuv/master/get.sh | bash
```
Or just download binaries
Thanks to [goreleaser](https://github.com/goreleaser/goreleaser) which makes publish binaries automaticly.
### Build from source
```sh
go get -d github.com/codeskyblue/gosuv
cd $GOPATH/src/github.com/codeskyblue/gosuv
go generate # package html resources into go
go build -tags vfs
```
## Quick start
After you installed gosuv, the first thing is to start server.
```sh
gosuv start-server
```
Basic operations
```sh
$ gosuv status
PROGRAM NAME STATUS
test running
test_again stopped
$ gosuv stop test
$ gosuv start test
```
Open web to see the manager page. And follow the gif to add a program to gosuv.
## Configuration
Default config file stored in directory `$HOME/.gosuv/`, Set env-var `GOSUV_HOME_DIR` can change config file store directory.
- file `programs.yml` contains all program settings.
- file `config.yml` contains server config
File `config.yml` can be generated by `gosuv conftest`
Example config.yaml
```
server:
httpauth:
enabled: true
username: admin
password: admin
addr: :8083
name: 10.10.99.177
master: ""
notifications:
dingtalk:
groups:
- secret: c1b8032******************aa736a
mobile:
- "153********"
client:
server_url: http://admin:admin@localhost:8083
```
master 的支持来自 https://github.com/ihaiker/distributed-gosuv
Logs can be found in `$HOME/.gosuv/log/`
Edit config file(default located in `$HOME/.gosuv/programs.yml`) and run `gosuv reload` will take effect immediately.
## Design
HTTP is follow the RESTFul guide.
Get or Update program
` /api/programs/:name`
Add new program
`POST /api/programs`
Del program
`DELETE /api/programs/:name`
## State
Only 4 states. [ref](http://supervisord.org/subprocess.html#process-states)
## Notification
Configuration example
```yaml
- demo-program:
command: ...
notifications:
pushover:
api_key: [token]
users:
- [user1]
- [user2]
```
Now only support [pushover](https://pushover.net/api), and only status change to fatal will get notified.
## Integrate with github (todo)
This is feature that will helps update your deployment environment once your updated in the github.
This part is set in the `programs.yml`, take look the example
```yml
- demo-program:
command: python app.py
directory: /opt/demo
webhook:
github:
secret: 123456
command: git pull origin master
```
## Alternative
- Go implementation of supervisor
## LICENSE
[MIT](LICENSE)