unifios-utilities/haproxy
Jordan Jones e8951ae5df
Add example of how to integrate haproxy (#239)
* add: haproxy scripts

* add: haproxy readme

I am really bad at writing instructions.
2021-10-08 18:30:21 -07:00
..
50-haproxy.sh Add example of how to integrate haproxy (#239) 2021-10-08 18:30:21 -07:00
README.md Add example of how to integrate haproxy (#239) 2021-10-08 18:30:21 -07:00
update-haproxy.sh Add example of how to integrate haproxy (#239) 2021-10-08 18:30:21 -07:00

Run haproxy on your UDM

Features

  1. Load balance services on your UDM, because why not?.
  2. Persists through reboots and firmware updates.

Requirements

  1. You have successfully setup the on boot script described here
  2. You have to have services you want to load-balance, an example would be a multi-master k3s cluster.

Steps

  1. Pull your image with podman pull docker.io/library/haproxy.

  2. (Optional) Configure a network using the generic cni network 20-dns.conflist and update its values to reflect your environment

  3. Copy 50-haproxy.sh to /mnt/data/on_boot.d/50-haproxy.sh.

  4. Create a persistant directory and config for haproxy to use:

    mkdir -p /mnt/data/haproxy
    touch /mnt/data/haproxy/haproxy.cfg
    
  5. Add your config to /mnt/data/haproxy/haproxy.cfg. Each configuration is unique, so check out some resouces like haproxy.com for basics.

  6. Run /mnt/data/on_boot.d/50-haproxy.sh

Upgrading Easily (if at all)

  1. Edit update-pihole.sh to use the same command you used at installation (if changed).
  2. Copy the update-pihole.sh to /mnt/data/scripts
  3. Anytime you want to update your installation, simply run /mnt/data/scripts/update-pihole.sh