Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kobolog/gorb
IPVS on steroids – REST API, heartbeats, service discovery and more
https://github.com/kobolog/gorb
Last synced: 1 day ago
JSON representation
IPVS on steroids – REST API, heartbeats, service discovery and more
- Host: GitHub
- URL: https://github.com/kobolog/gorb
- Owner: kobolog
- License: lgpl-3.0
- Created: 2015-10-21T18:04:08.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2024-04-28T16:48:32.000Z (8 months ago)
- Last Synced: 2024-11-22T05:04:35.858Z (20 days ago)
- Language: Go
- Homepage:
- Size: 23.3 MB
- Stars: 812
- Watchers: 54
- Forks: 81
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-repositories - kobolog/gorb - IPVS on steroids – REST API, heartbeats, service discovery and more (Go)
README
## GORB [](https://travis-ci.org/kobolog/gorb) [](https://codecov.io/github/kobolog/gorb?branch=master)
**Go Routing and Balancing**
This daemon is an IPVS frontend with a REST API interface. You can use it to control local IPVS instance in the Kernel to dynamically register virtual services and backends. It also supports basic TCP and HTTP health checks (called Gorb Pulse).
- **TCP**: tries to establish a TCP connection to the backend's host and port.
- **HTTP**: tries to fetch a specified location from backend's host and port.
Backends which fail to pass the health check will have weights set to zero to inhibit any traffic from being routed into their direction. When a backend comes back online, GORB won't immediately set its weight to the previous value, but instead gradually restore it based on backend's accumulated health statistics.
GORB also supports basic service discovery registration via [Consul](https://www.consul.io): just pass in the Consul endpoint to GORB and it will take care of everything else – your services will be registered with names like `nginx-80-tcp`. Keep in mind that you can use Consul's built-in DNS server to make it even easier to discover your services!
Check out these [slides for my DockerCon EU 2015 talk](http://www.slideshare.net/kobolog/ipvs-for-docker-containers) for more information about IPVS, GORB and how to use it with Docker.
## Configuration
There's not much of a configuration required - only a handlful of options can be specified on the command line:
gorb [-c ] [-f flush-pools] [-i interface] [-l listen-address] | -h
By default, GORB will listen on `:4672`, bind services on `eth0` and keep your IPVS pool intact on launch.
## REST API
- `PUT /service/` creates a new virtual service with provided options. If `host` is omitted, GORB will pick an
address automatically based on the configured default device:
```json
{
"host": "10.0.0.1",
"port": 12345,
"protocol": "tcp|udp",
"method": "rr|wrr|lc|wlc|lblc|lblcr|sh|dh|sed|nq|...",
"persistent": true,
"flags": "sh-fallback|sh-port",
}
```
This scheduler has two flags: sh-fallback, which enables fallback to a different server if the selected server was unavailable, and sh-port, which adds the source port number to the hash computation.
- `PUT /service//` creates a new backend attached to a virtual service:
```json
{
"host": "10.1.0.1",
"port": 12346,
"method": "nat|tunnel",
"pulse": {
"type": "none|tcp|http",
"args": {
"method": "GET",
"port": 54321,
"path": "/health",
"expect": 200
},
"interval": "5s"
},
"weight": 100
}
```
- `DELETE /service/` removes the specified virtual service and all its backends.
- `DELETE /service//` removes the specified backend from the virtual service.
- `GET /service/` returns virtual service configuration.
- `GET /service//` returns backend configuration and its health check metrics.
- `PATCH /service/` update virtual service configuration.
- `PATCH /service//` update backend configuration and its health check metrics.
For more information and various configuration options description, consult [`man 8 ipvsadm`](http://linux.die.net/man/8/ipvsadm).
## Development
Use glide to install dependencies:
glide install -v
This should be done periodically to retrieve any updated dependencies.
## TODO
- [ ] Add more options for Gorb Pulse: thresholds, exponential back-offs and so on.
- [ ] Support for IPVS statistics (requires GNL2GO support first).
- [ ] Support for FWMARK & DR virtual services (requires GNL2GO support first).
- [x] Add service discovery support, e.g. automatic Consul service registration.
- [ ] Add BGP host-route announces, so that multiple GORBs could expose a service on the same IP across the cluster.
- [ ] Add some primitive UI to present the same action palette but in an user-friendly fashion.
- [ ] Replace command line options with proper configuration via a JSON/YAML/TOML file.