Easy HAProxy

This Docker image will create dynamically the haproxy.cfg based on the arguments defined in the command line.

Features

Enable or disable Stats on port 1936 with custom password
Add a mapping from a host to another based on Environment Variables
Dont need to setup .cfg file
You can add custom .cfg file by mapping the conf.d folder

Usages

The most common use is to use on Docker Swarm environment when you don't want to expose the container ports and use a Load Balance to deliver to this component in the same overlay network

Basic Usage

You have to define 3 variables (LB_STATS_USER, LB_STATS_PASS, LB_HOSTS).

Example:

HAProxy with statistics and password "mypassowrd" for the user "admin"
Domain my.domain.com routing to container/host container1 on port 8080
Domain other.domain.com routing to container/host other on port 7000

docker run \ 
    -e LB_STATS_USER=admin \
    -e LB_STATS_PASS=mypassword \
    -e LB_HOSTS="my.domain.com container1:8080 other.domain.com other:7000" \
    -p 80:80 \
    --name easy-haproxy-instance \
    -d byjg/easy-haproxy

Mapping custom .cfg files

Just create a folder and put files with the extension .cfg. and map the volume to the container. This will concatenate your config into the main haproxy.cfg

docker run \ 
    /* other parameters */
    -v /your/local/conf.d:/etc/haproxy/conf.d \
    -d byjg/easy-haproxy

Check if your config is ok:

docker run \ 
    /* other parameters */
    -v /your/local/conf.d:/etc/haproxy/conf.d \
    -byjg/easy-haproxy -c -f /etc/haproxy/haproxy.cfg

Build

docker build -t byjg/easy-haproxy .

1.7 KiB Raw Blame History