cloudxtreme / gorb

Go Routing and Balancing

GORB

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.

Configuration

There's not much of a configuration required - only a handlful of options can be specified on the command line:

gorb [-l <listen-address>] [-d <device>] [-f flush-pools] | -h

By default, GORB will listen on :4672, bind services on eth0 and keep your IPVS pool intact on launch.

REST API

• PUT /service/<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:

{
    "host": "10.0.0.1",
    "port": 12345,
    "protocol": "tcp|udp",
    "method": "rr|wrr|lc|wlc|lblc|lblcr|sh|dh|sed|nq|...",
    "persistent": true
}

• PUT /service/<service>/<backend> creates a new backend attached to a virtual service:

{
    "host": "10.1.0.1",
    "port": 12346,
    "method": "nat|tunnel",
    "pulse": {
        "type": "none|tcp|http",
        "interval": "5s",
        "path": "/health (ignored for tcp pulse)"
    },
    "weight": 100
}

• DELETE /service/<service> removes the specified virtual service and all its backends.
• DELETE /service/<service>/<backend> removes the specified backend from the virtual service.
• GET /service/<service> returns virtual service configuration.
• GET /service/<service>/<backend> returns backend configuration and its health check metrics.

For more information and various configuration options description, consult man 8 ipvsadm.

TODO

• Add more options for Gorb Pulse: thresholds, HTTP verbs and expected responses, exponential back-offs and so on.
• Support for IPVS statistics (requires GNL2GO support first).
• Support for FWMARK & DR virtual services.
• 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.
• Add dynamic DNS registration support, so that GORBs could register new service names on some provided subdomain.