tinylb

A small but mighty TCP load balancer written in Go.

Features

Zero-downtime configuration changes
Update the load balancer without interruptions to any existing connections. See config.json for an example config.

Sticky sessions
Clients are assigned stably to targets using consistent hashing.

Multiple target groups
Distribute load for many services via one load balancer instance - a barebones analogue to AWS ELB's target group construct.

Graceful shutdown
Safely terminate the load balancer without interruption to open connections.

Installation

Install the latest release from GitHub.

go install -v github.com/jacoblurye/tinylb/cmd/tinylb@latest

Usage

Start a load balancer.

tinylb -config-path config.json

To update tinylb's config on-the-fly, simply save a change to the config file, and tinylb will automatically pull in and apply the change.