lb

a reverse proxy load-balancing server, It implements the Weighted Round Robin Balancing algorithm referenced here.

Installing | How to Use | Configuration

Installing

Using go install

You can use the command below to compile and install directly to your $GOPATH/bin

go install github.com/pariola/lb@latest

How to Use

After installing, run the command below to start the server:

lb <PATH TO CONFIG FILE>

Now the server proxies every request to downstream backends.

Configuration

Configuration format is YAML and path defaults to lb.yml.

Available Values

Name	Description	Default
port	Port the server will listen on	3000
retries	Amount retries per request	1
health.path	URL path to listen to for liveness checks	/
health.interval	Interval to perform the liveness checks	30s
backends.[].host	Downstream Server URL to proxy requests to (ex. localhost:4023)	-
backends.[].weight	Weight to influence the amount of requests received by the downstream backend	1

Example Configuration:

port: 5000
retires: 5
health:
  path: /health
  interval: 30s
backends:
  - host: "localhost:5000"
    weight: 2
  - host: "localhost:5001"
    weight: 1