Documentation et communauté
1. Documentation disponible
La documentation complète de HAProxy est contenue dans les documents suivants. Veuillez vous assurer de consulter la documentation pertinente afin d’économiser du temps et d’obtenir la réponse la plus précise à vos besoins. Veuillez également vous abstenir d’envoyer des questions à la liste de diffusion dont les réponses sont déjà disponibles dans ces documents.
intro.txt(ce document) : il présente les bases de la répartition de charge, HAProxy en tant que produit, ses fonctionnalités, ses limites, certains pièges à éviter, certaines limitations propres aux systèmes d’exploitation, comment l’obtenir, son évolution, comment s’assurer d’exécuter une version avec tous les correctifs connus, comment le mettre à jour, ainsi que des compléments et des alternatives.management.txt: il explique comment démarrer HAProxy, comment le gérer en temps réel, comment le gérer sur plusieurs nœuds, et comment procéder à des mises à jour sans interruption.configuration.txt: le manuel de référence détaille tous les mots-clés de configuration et leurs options. Il est utilisé lorsqu’une modification de configuration est nécessaire.coding-style.txt : destiné aux développeurs souhaitant proposer du code au projet. Il décrit le style à adopter pour le code. Il n’est pas très strict et l’ensemble du code ne le respecte pas entièrement, mais les contributions s’en écartant trop seront rejetées.
proxy-protocol.txt : il s’agit de la spécification de facto du protocole PROXY, implémentée par HAProxy et un certain nombre de produits tiers.
security.txt : comment signaler un problème de sécurité, et ce qui constitue ou ne constitue pas une vulnérabilité.
README : comment compiler HAProxy à partir des sources
5. Contacts
Si vous souhaitez contacter les développeurs ou un membre de la communauté à propos de quoi que ce soit, la meilleure façon de procéder est généralement d’envoyer votre message à la liste de diffusion à l’adresse haproxy@formilux.org . Veuillez noter que cette liste est publique ainsi que ses archives, vous devez donc éviter de divulguer des informations sensibles. Des milliers d’utilisateurs, de tous niveaux d’expérience, y sont présents, et les questions les plus complexes trouvent généralement une réponse optimale relativement rapidement. Les suggestions sont également les bienvenues. Pour les utilisateurs ayant des difficultés avec le courrier électronique, une plateforme Discourse est disponible à l’adresse http://discourse.haproxy.org/ . Toutefois, veuillez garder à l’esprit qu’un nombre réduit de personnes lisent les questions posées là-bas, et que la plupart sont traitées par une équipe extrêmement réduite. Dans tous les cas, veuillez être patient et respectueux envers ceux qui consacrent leur temps libre à aider les autres.
Si vous pensez avoir découvert un bogue mais n’en êtes pas certain, il est préférable de le signaler sur la liste de diffusion. Si vous êtes convaincu d’avoir trouvé un bogue, que votre version est à jour dans sa branche, et que vous disposez déjà d’un compte GitHub, vous pouvez directement vous rendre sur https://github.com/haproxy/haproxy/ et soumettre un problème en incluant toutes les informations disponibles. Encore une fois, cela est public, veillez donc à ne pas publier d’informations que vous pourriez regretter plus tard. Étant donné que le suivi des problèmes s’affiche sous la forme d’un fil très long, évitez de coller des extraits très longs (plusieurs centaines de lignes ou plus) et joignez-les à la place.
Si vous pensez avoir découvert un problème de sécurité, veuillez vous référer au fichier doc/security.txt. Il explique ce qui constitue ou ne constitue pas une vulnérabilité dans HAProxy, ainsi que la procédure à suivre pour signaler une vulnérabilité réelle de manière confidentielle. La plupart des problèmes suspectés s’avèrent être des bogues ordinaires, mieux signalés comme décrit ci-dessus.
Configuration locale complète manuelle
Édition provenance
- Édition : HAProxy 3.4.4, balise
v3.4.4 - Commit source :
7f03ae65c286 - Version rendue de la documentation : docs.HAProxy.org/3.4/
- Copies locales de la licence : avis de licence HAProxy et GPLv2