lusu777/haproxy-consul repository overview

⁠haproxy-consul

Dynamic haproxy configuration using consul packed into a Docker container that weighs 18MB.

⁠Overview

This project combines Alpine Linux⁠, consul template⁠, and haproxy⁠ to create a proxy that forwards traffic to services registered in consul.

⁠How it works

First, you must set up a wildcard dns (using something like CloudFlare or xip.io⁠). This means that if your domain is example.com, any request to a <name>.example.com will resolve to the IP of your haproxy container.

Inside the haproxy container, a header match is used to map <application>.example.com to the service registered in consul under aplication.

⁠Building

  docker build -t haproxy . 

⁠Running

If you don't want to configure wildcard dns, you can use xip.io. In this example, we are going to assume that the IP of your server is 180.19.20.21, then all domains in 180.19.20.21.xip.io will forward to your host.

Start the container as follows:

docker run --net=host --name=haproxy -d -e HAPROXY_DOMAIN=180.19.20.21.xip.io asteris/haproxy-consul

If you have wildcard DNS set up for your company (say at *.mycompany.com) use the following:

docker run --net=host --name=haproxy -d -e HAPROXY_DOMAIN=mycompany.com asteris/haproxy-consul  

Now that it is set up, connect to an app registered via consul.

curl -L http://myapp.mycompany.com

Or if you do not have a wildcard DNS

curl -L http://myapp.180.19.20.21.xip.io

⁠Options

If you wish to override the config and template files, mount a volume and change the CONSUL_CONFIG environment variable upon launch. In docker this is via the -e option:

docker run -v /host/config:/my_config -e CONSUL_CONFIG=/my_config -net=host --name=haproxy -d -e HAPROXY_DOMAIN=mycompany.com asteris/haproxy-consul 

Configure using the following environment variables:

  HAPROXY_DOMAIN        The domain to match against
                        (default: example.com for app.example.com)

Consul-template variables:
  CONSUL_TEMPLATE       Location of consul-template bin 
                        (default /usr/local/bin/consul-template)


  CONSUL_CONNECT        The consul connection
                        (default consul.service.consul:8500)

  CONSUL_CONFIG         File/directory for consul-template config
                        (/consul-template/config.d)


  CONSUL_LOGLEVEL       Valid values are "debug", "info", "warn", and "err".
                        (default is "debug")

⁠License

Released under an Apache 2.0 License. See LICENSE