Skip to content
A fast, modern, zero-conf load balancing HTTP(S) router for deploying microservices managed by consul.
Branch: master
Clone or download
Pull request Compare This branch is 1 commit ahead, 672 commits behind fabiolb:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
admin
assert
build
cert
config
demo
docs
exit
metrics
proxy
registry
route
vendor
.gitignore
.travis.yml
CHANGELOG.md
Dockerfile
LICENSE
Makefile
README.md
fabio.png
fabio.properties
listen.go
listen_test.go
main.go

README.md

./fabio

Current stable version: 1.3.5

Build Status License MIT

fabio is a fast, modern, zero-conf load balancing HTTP(S) router for deploying applications managed by consul.

Register your services in consul, provide a health check and fabio will start routing traffic to them. No configuration required. Deployment, upgrading and refactoring has never been easier.

fabio is developed and maintained by Frank Schroeder at eBay in Amsterdam. It powers some of the largest websites in The Netherlands (marktplaats.nl), Australia (gumtree.com.au) and Italy (www.kijiji.it). It delivers 23.000 req/sec every day since Sep 2015 without problems.

It integrates with Consul, Vault, Amazon ELB, Amazon API Gateway and more.

It supports SSL, TCP+SNI proxy (full end-to-end TLS), Websockets, SSE, dynamic reloading, traffic shaping for "blue/green" deployments, Circonus metrics, Graphite metrics, StatsD/DataDog metrics, WebUI and more.

Watch Kelsey Hightower demo Consul, Nomad, Vault and fabio at HashiConf EU 2016.

The full documentation is on the Wiki.

Getting started

  1. Install from source, binary, Docker or Homebrew.

    # go 1.7 or higher is required
    go get github.com/eBay/fabio                        (>= go1.7)
    
    brew install fabio                                  (OSX/macOS stable)
    brew install --devel fabio                          (OSX/macOS devel)
    
    docker pull magiconair/fabio                        (Docker)
    
    https://github.com/eBay/fabio/releases              (pre-built binaries)
    
  2. Register your service in consul.

    Make sure that each instance registers with a unique ServiceID.

  3. Register a health check in consul as described here.

    Make sure the health check is passing since fabio will only watch services which have a passing health check.

  4. Register one urlprefix- tag per host/path prefix it serves, e.g.:

    • urlprefix-/css
    • urlprefix-i.com/static
    • urlprefix-mysite.com/

    Make sure the prefix contains at least one slash (/).

  5. Start fabio without a config file (assuming a running consul agent on localhost:8500) Watch the log output how fabio picks up the route to your service. Try starting/stopping your service to see how the routing table changes instantly.

  6. Send all your HTTP traffic to fabio on port 9999

  7. Done

License

MIT licensed

You can’t perform that action at this time.