Adding some documentation

This commit is contained in:
Gregory Ballantine
2026-04-08 11:30:25 -04:00
parent dd0ebf4a43
commit bcd5d5051f

View File

@@ -1,3 +1,31 @@
# ansible-role-haproxy
Ansible role to install and configure HAProxy load balancer
Ansible role to install and configure HAProxy load balancer
## Installation
In your Ansible repo's `requirements.txt` file, you can include it as detailed below and install it via `ansible-galaxy`.
```yaml
roles:
- src: ascendings.haproxy
version: 0.1.0 # change this as needed
```
## vars
This section lists the available vars to configure this role.
`haproxy_backend_servers` - A hash of servers to use in the backend; example:
```yaml
haproxy_backend_servers:
- name: web01
address: 192.168.1.10
port: 80 # optional; default is 80
- name: web02
address: 192.168.1.11
port: 80
```
`haproxy_backend_balance` - Defines the backend load-balancing method; refer to [the HAProxy docs]() for valid options.