Documentation

PLEASE NOTE: This document applies to latest version and not to the latest stable release v2.20

Documentation for other releases can be found by using the version selector in the top right of any doc page.

haproxy

Manage HAProxy load balancer backend and frontend configurations.

Attributes

check_mode:
  support: full

Parameters

Parameter	Required	Type	Values	Description
balance		string		Load balancing algorithm (e.g., roundrobin, leastconn, source).
check		string		Health check option string (e.g., “option httpchk GET /health”).
config_file		string		Path to the HAProxy configuration file. [default: `"/etc/haproxy/haproxy.cfg"`]
name	true	string		Backend or frontend section name.
section		string	backend frontend listen	Section type to manage. [default: `"backend"`]
servers		array		List of backend servers with name, address, and optional check flag.
state		string	present absent	Whether the section should be present or absent. [default: `"present"`]

Examples

- name: Create backend with servers
  haproxy:
    config_file: /etc/haproxy/haproxy.cfg
    name: web_backend
    state: present
    servers:
      - name: web1
        address: 192.168.1.10:80
      - name: web2
        address: 192.168.1.11:80
    balance: roundrobin

- name: Create backend with health checks
  haproxy:
    config_file: /etc/haproxy/haproxy.cfg
    name: web_backend
    state: present
    balance: leastconn
    check: option httpchk GET /health
    servers:
      - name: web1
        address: 192.168.1.10:80
        check: true
      - name: web2
        address: 192.168.1.11:80
        check: true

- name: Remove backend
  haproxy:
    config_file: /etc/haproxy/haproxy.cfg
    name: old_backend
    state: absent

- name: Create frontend
  haproxy:
    config_file: /etc/haproxy/haproxy.cfg
    name: http-in
    section: frontend
    state: present
    check: bind *:80