https://github.com/hlts2/glber
Simple lightweight load balancer written in golang
https://github.com/hlts2/glber
go golang hlts2 lightweight load-balancer loadbalancer
Last synced: 6 months ago
JSON representation
Simple lightweight load balancer written in golang
- Host: GitHub
- URL: https://github.com/hlts2/glber
- Owner: hlts2
- License: mit
- Created: 2018-07-17T10:08:46.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2019-03-14T17:06:44.000Z (over 6 years ago)
- Last Synced: 2025-04-09T23:14:08.760Z (6 months ago)
- Topics: go, golang, hlts2, lightweight, load-balancer, loadbalancer
- Language: Go
- Homepage:
- Size: 2.49 MB
- Stars: 5
- Watchers: 3
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# glber [](https://opensource.org/licenses/MIT) [](http://godoc.org/github.com/hlts2/glber) [](https://goreportcard.com/report/github.com/hlts2/glber) [](https://gitter.im/hlts2/glber?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
glber is a simple lightweight load balancer written in golang.
## Requirement
Go (>= 1.9)
## Installation
```shell
go get github.com/hlts2/glber
```
## Example
### Config file
Config file `config.yml` describes configuration of load balancer.
The following is a setting example.
```yaml
host: 0.0.0.0
port: 80
balancing: round-robin
tls:
enabled: true
cert_key: ./cert.key
key_key: ./key.key
servers:
- scheme: http
host: 192.168.33.11
port: 1111
- scheme: http
host: 192.168.33.11
port: 2222
- scheme: http
host: 192.168.33.11
```
### Balancing Algorithm
There are three possible algorithms for balancing
- [round-robin](https://github.com/hlts2/round-robin)
- [ip-hash](https://github.com/hlts2/ip-hash)
- [least-connections](https://github.com/hlts2/least-connections)
Please write algorithm name in `balancing` field of `config.yml` file
```
balancing: round-robin # or ip-hash or least-connections
```
### Basic Example
```
$ glber serve -s config.yml
```
## CLI Usage
```
$ glber --help
NAME:
glber - Load Balancer
USAGE:
glber [global options] command [command options] [arguments...]
VERSION:
v1.0.0
COMMANDS:
serve serve load balancer
help, h Shows a list of commands or help for one command
GLOBAL OPTIONS:
--help, -h show help
--version, -v print the version
```
### Serve command
```
$ glber serve --help
NAME:
glber serve - serve load balancer
USAGE:
glber serve [command options] [arguments...]
OPTIONS:
--set value, -s value set the configuration file (default: "config.yml")
```
## TODO
- [ ] Helth check of service
## Author
[hlts2](https://github.com/hlts2)
## LICENSE
glber released under MIT license, refer [LICENSE](https://github.com/hlts2/glber/blob/master/LICENSE) file.