iby / docker-haproxy

Dockerised HAProxy under 6.5 MB

Docker HAProxy

Docker HAProxy image is built on top of Alpine Linux micro OS with the final image size of 6.37 MB vs. 97.89 MB compared to the official haproxy:latest. Allows to run haproxy with multiple configuration files if you prefer to keep things neat and separate.

Running

Pull or build the image yourself and run it. Before you do that you'll need to get the configuration ready. Probably the most useful documentation on how to do that is at cbonte.github.io/haproxy-dconv with a few examples available inside the /configuration folder. Configuration can be passed either via a mounted volume or baked right into the image during the build.

# Prepare configuration, you can use multiple files or a single file.

cat <<-EOL > '/configuration/defaults.cfg'
	defaults
	    mode tcp
	    timeout connect 5s
	    timeout client 1m
	    timeout server 1m
EOL

cat <<-EOL > '/configuration/git.cfg'
	frontend http
	    bind *:80
	    default_backend app

	backend app
	    balance roundrobin
	    server node01 github.com:80
	    server node02 bitbucket.com:80
EOL

# Build…
docker build -t ianbytchek/haproxy .

# Or pull…
docker pull ianbytchek/haproxy

# Run, configuration MUST be provided via a mounted volume.
docker run \
    --detach \
    --name 'haproxy' \
    --publish '80:80' \
    --publish '443:443' \
    --volume '/configuration:/etc/haproxy' \
    ianbytchek/haproxy

Configuration

One thing to keep in mind, the container will first check if there's a haproxy.cfg file in /etc/haproxy and use that, even if there are other configuration files – that's in case when you want to use multiple configuration files. So, if you do, make sure you don't name any of them haproxy.cfg.