Pylon

A Go Reverse Proxy and Load balancer

Usage

You just need a config, for example:

{
"servers": [
{
"name": "server1",
"port": 7777,
"monitoring_route": "/health",
"services": [
{
"name": "Billing Service",
"route_prefix": "/microservice/",
"instances": [
{
"host": "127.0.0.1:1111",
"weight": 3
},
{
"host": "127.0.0.1:2222"
},
{
"host": "127.0.0.1:3333"
}
],
"balancing_strategy": "round_robin",
"max_connections": 300,
"health_check": {
"enabled": true,
"interval": 30,
"dial_timeout": 2
}
}
]
}
]
}

Notes:

• Pylon supports regular expressions, you can replace "route_prefix": "/microservice/" with "route_pattern": "/microservice/*" or any valid regular expression

• Strategies are specified with the "balancing_strategy" tag. Options are: "round_robin" / "least_connected" / "random"

• All durations are in second.

• If "max_connections" isn't specified or set to 0, the default max connections is 100 000

Simply use Pylon in your library or main like this:

package main
import (
"github.com/leonardbesson/pylon""log""os"
)
funcmain() {
f, err:=os.OpenFile("pylon.log", os.O_RDWR|os.O_CREATE|os.O_TRUNC, 0666)
iferr!=nil {
log.Fatalf("error opening file: %v", err)
}
deferf.Close()
// Redirect the logging to a filepylon.SetLogWriter(f)
// Set the logging levelspylon.SetLogLevels(pylon.LOG_ERROR|pylon.LOG_INFO)
// Specify a custom logging function (default is log.Println prefixed with (ERROR|DEBUG|INFO|VERBO)pylon.SetInfoLogger(log.Println)
pylon.SetErrorLogger(log.Println)
pylon.SetVerboseLogger(log.Println)
log.Fatal(pylon.ListenAndServe("./config.json"))
}

Executables

If you don't want to use Pylon in your own library or main, I have put pre-compiled executables (Win x64 and Linux x64) running a simple main in the "Release" section.

Launch it with the config file named "config.json" in the same directory and it will create a log file named "pylon.log". You can also specify the config and log files, for example:

 ./pylon_linux_x64 -c /path/to/config.json -log /your/log/file