https://github.com/deveryware/ansible-haproxy
Installs and configures HAProxy
https://github.com/deveryware/ansible-haproxy
ansible ansible-role centos debian haproxy ubuntu
Last synced: 6 months ago
JSON representation
Installs and configures HAProxy
- Host: GitHub
- URL: https://github.com/deveryware/ansible-haproxy
- Owner: Deveryware
- License: apache-2.0
- Created: 2018-09-12T13:49:39.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2024-09-27T15:38:21.000Z (about 1 year ago)
- Last Synced: 2025-04-04T19:23:49.972Z (7 months ago)
- Topics: ansible, ansible-role, centos, debian, haproxy, ubuntu
- Language: Jinja
- Homepage:
- Size: 214 KB
- Stars: 18
- Watchers: 6
- Forks: 11
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
haproxy
========
Installs and configures [HAProxy](http://www.haproxy.org/).
Versions
--------
The **current** release is [1.5.0](https://github.com/deveryware/ansible-haproxy/tree/v1.4.0).
The **next** release is in development (Cf. [the projects tab](https://github.com/Deveryware/ansible-haproxy/projects)).
Features
--------
* Supports CentOS and Debian (Ubuntu should work)
* Installs HAProxy from official repositories on Debian.
* Installs HAProxy from EPEL repository on CentOS.
* Tests via Molecule and Docker
Requirements
------------
The python library `jmespath` is required on the control node.
Role Variables
--------------
* `haproxy_global`
Global HAProxy settings.
* `haproxy_defaults`
Default settings for frontends, backends, and listen proxies.
* `haproxy_resolvers`
A list of HAProxy resolvers.
* `haproxy_backends`
A list of HAProxy backends.
* `haproxy_frontends`
A list of HAProxy frontends.
* `haproxy_listen`
A list of listen proxies.
* `haproxy_logforward`
A list of log-forward proxies (Only for HAProxy version 2.3 and above).
* `haproxy_peers`
A list of peers.
See [`vars/main.yml`](vars/main.yml) for a complete list of configurable .
See [the wiki](https://github.com/Deveryware/ansible-haproxy/wiki) for more details.
Example
-------
```yaml
- hosts: loadbalancers
roles:
- role: haproxy
haproxy_frontends:
- name: 'fe-mysupersite'
ip: '123.123.123.120'
port: '80'
maxconn: '1000'
default_backend: 'be-mysupersite'
haproxy_backends:
- name: 'be-mysupersite'
description: 'mysupersite is really cool'
servers:
- name: 'be-mysupersite-01'
ip: '192.168.1.100'
log-forward:
- name: 'my-syslog-lb'
dgrambind:
- '127.0.0.1:514' # Listen on UDP IPv4
log:
- ip: '192.168.1.101'
port: 5514
sample_range: "1:2"
facility: "local0 info"
- ip: '192.168.1.102'
port: 5514
sample_range: "3:4"
facility: "local0 info"
```
Testing
-------
To test the role you first need to install Molecule with :
```
$ pip install molecule docker
```
If you encounter a problem while installing with pip, install [python-dev](https://stackoverflow.com/a/21530768)
To run the tests, execute :
```
$ molecule test
```
License
------
Apache v2
Author Information
------------------
This role was created in 2014 by Pheromone - Pierre Paul Lefebvre (lefebvre@pheromone.ca).
This role was forked in 2019 by Deveryware.
[The contributors list](https://github.com/Deveryware/ansible-haproxy/blob/master/AUTHORS)