HAProxy Salt Formula
Find a file
2015-02-24 22:19:02 +01:00
haproxy Added jinja templated configuration support, a bit of documentation and a rough set of examples 2015-02-24 22:19:02 +01:00
LICENSE Add LICENSE. 2013-07-27 22:17:09 +02:00
pillar.example Added jinja templated configuration support, a bit of documentation and a rough set of examples 2015-02-24 22:19:02 +01:00
README.rst Added jinja templated configuration support, a bit of documentation and a rough set of examples 2015-02-24 22:19:02 +01:00

haproxy
=======

haproxy
-------

Install, configure and run haproxy based on:

haproxy.install
haproxy.config
haproxy.service

Use the supplied haproxy.cfg for a flat file approach,
or the jinja template and the pillar for a salt approach.

haproxy.config
--------------

Currently, only a handful of options can be set using the pillar:

- Global
  - stats: enable stats, curently only via a unix socket which can be set to a path
  - user: sets the user haproxy shall run as
  - group: sets the group haproxy shall run as
  - chroot: allows you to turn on chroot and set a directory
  - daemon: allows you to turn daemon mode on and off

- Default
  - log: set the default log
  - mode: sets the mode (i.e. http)
  - retries: sets the number of retries
  - options: an array of options that is simply looped with no special treatment
  - timeouts: an array of timeouts that is simply looped with no special treatment
  - errorfiles: an array of k:v errorfiles to point to the correct file matching an HTTP error code

- Frontend
  Frontend(s) is a list of the frontends you desire to have in your haproxy setup
  Per frontend you can set:
  - name: the name haproxy will use for the frontend
  - bind: the bind string: this allows you to set the IP, Port and other paramters for the bind
  - reqadd: an array of reqadd statements. Looped over and put in the configuration, no parsing
  - default_backend: sets the default backend
  - acls: a list of acls, not parsed, simply looped and put in to the configuration
  - use_backends: a list of use_backend statements, looped over, not parsed

- Backend
  Backend(s) is a list of the backends you desire to have in your haproxy setup
  Per backend you can set:
  - name: set the backend name, used in the frontend references by haproxy
  - balance: set the balance type, string
  - redirect: if set, can be used to redirect; simply a string, not parsed
  - servers: a list of servers this backend will contact, is looped over
    - per server you can set:
      - name: name of the server for haproxy
      - host: the host to be contacted
      - port: the port to contact the server on
      - check: set to check to enable checking