Rôle Ansible : HAProxy

Installe HAProxy sur les serveurs Linux RedHat/CentOS et Debian/Ubuntu.

Note : Ce rôle prend en charge officiellement les versions HAProxy 1.4 ou 1.5. Les futures versions peuvent nécessiter quelques modifications.

Exigences

Aucune.

Variables du Rôle

Les variables disponibles sont listées ci-dessous, avec les valeurs par défaut (voir defaults/main.yml) :

haproxy_socket: /var/lib/haproxy/stats

Le socket par lequel HAProxy peut communiquer (pour des raisons administratives ou des statistiques). Pour désactiver ou supprimer cette directive, définissez haproxy_socket: '' (une chaîne vide).

haproxy_chroot: /var/lib/haproxy

Le répertoire de prison où chroot() sera effectué avant de donner des privilèges réduits. Pour désactiver ou supprimer cette directive, définissez haproxy_chroot: '' (une chaîne vide). Ne modifiez cela que si vous savez ce que vous faites !

haproxy_user: haproxy
haproxy_group: haproxy

L'utilisateur et le groupe sous lesquels HAProxy doit fonctionner. Ne modifiez cela que si vous savez ce que vous faites !

haproxy_frontend_name: 'hafrontend'
haproxy_frontend_bind_address: '*'
haproxy_frontend_port: 80
haproxy_frontend_mode: 'http'

Directives de configuration de frontend HAProxy.

haproxy_backend_name: 'habackend'
haproxy_backend_mode: 'http'
haproxy_backend_balance_method: 'roundrobin'
haproxy_backend_httpchk: 'HEAD / HTTP/1.1\r\nHost:localhost'

Directives de configuration de backend HAProxy.

haproxy_backend_servers:
  - name: app1
    address: 192.168.0.1:80
  - name: app2
    address: 192.168.0.2:80

Une liste de serveurs backend (nom et adresse) auxquels HAProxy distribuera les demandes.

haproxy_connect_timeout: 5000
haproxy_client_timeout: 50000
haproxy_server_timeout: 50000

Configurations de timeout par défaut de HAProxy.

haproxy_global_vars:
  - 'ssl-default-bind-ciphers ABCD+KLMJ:...'
  - 'ssl-default-bind-options no-sslv3'

Une liste de variables globales supplémentaires à ajouter à la section de configuration globale dans haproxy.cfg.

haproxy_template: haproxy.cfg.j2

Utilisez cette variable pour remplacer le modèle de configuration utilisé par ce rôle. Copiez le fichier modèle depuis le dossier templates de ce rôle dans le dossier templates de votre propre playbook pour le remplacer.

Dépendances

Aucune.

Exemple de Playbook

- hosts: balancer
  sudo: yes
  roles:
    - { role: geerlingguy.haproxy }

Licence

MIT / BSD

Informations sur l'Auteur

Ce rôle a été créé en 2015 par Jeff Geerling, auteur de Ansible for DevOps.