/goprocmgr

Primary LanguageGoISC LicenseISC

Check Update

goprocmgr

This program is a configuration manager and process runner for servers, it has an http API to manage and retrieve the configuration. It also provides a CLI client for interacting with the API.

It's inspired by Chalet which is a fork from Hotel. However, this aims to be way simpler in design, feature set and implementation.

Features

  • Remember configured "servers" by storing certain environment variables, directory and command to run to start it.
  • Start, stop and read logs from the different servers.
  • Simple http API to interact with the servers.
  • Command line tool to interact with the API.
  • Web UI to interact with the API.
  • Random port assignment for servers with the environment variable PORT.

Screenshot

Lack of Proxy

Unlike hotel and chalet this program does not provide a proxy to the running servers. This is a design choice bauces then we would need to listen to port 80 and 443 which would require root access. This would also require to support TLS and certificates. So there's just a whole bunch extra work.

So instead we just provide a random port to the server as an environment variable, then you'll be able to use that in the startup of your application.

In the list of running servers in the web UI you can click the link to the service to access it.

If you're running multiple services with docker you can make sure to put all your services on the same host network and then use something like jwilder/nginx-proxy to map the services up and have local domains to access all your services through the same port, just with different domains (like service1.local).

TODO

  • Implement direnv support direnv exec $dirname $command.
  • Implement keybind support in the web interface (esc to unselect server, t to toggle server, n for next server, p for previous server).
  • Implement an overview of the keybind in the web interface (press h to display popup).
  • Refresh data and interface over websockets.
  • Improve the kill check for stopped processes.
  • Implement a dynamic favicon to include a number of running servers.
  • Implement parsing of terminal colors to display these in the web (and also terminate them at end of lines in CLI tail)
  • Implement a getting started overview in the web interface on the frontpage.