aabde71332
I was looking at writing a simple first test for prometheus but I realised there is no proper way to exclude it if haproxy was not built with prometheus plugin. Today we have `REQUIRE_OPTIONS` in reg-tests which is based on `Feature list` from `haproxy -vv`. Those options are coming from the Makefile itself. A plugin is build this way: EXTRA_OBJS="contrib/prometheus-exporter/service-prometheus.o" It does register service actions through `service_keywords_register`. Those are listed through `list_services` in `haproxy -vv`. To facilitate parsing, I slightly changed the output to a single line and integrate it in regtests shell script so that we can now specify a dependency while writing a reg-test for prometheus, e.g: #REQUIRE_SERVICE=prometheus-exporter #REQUIRE_SERVICES=prometheus-exporter,foo There might be other ways to handle this, but that's the cleanest I found; I understand people might be concerned by this output change in `haproxy -vv` which goes from: Available services : foo bar to: Available services : foo bar Signed-off-by: William Dauchy <wdauchy@gmail.com> |
||
---|---|---|
.github | ||
contrib | ||
doc | ||
examples | ||
include | ||
reg-tests | ||
scripts | ||
src | ||
tests | ||
.cirrus.yml | ||
.gitattributes | ||
.gitignore | ||
.travis.yml | ||
BRANCHES | ||
CHANGELOG | ||
CONTRIBUTING | ||
INSTALL | ||
LICENSE | ||
MAINTAINERS | ||
Makefile | ||
README | ||
ROADMAP | ||
SUBVERS | ||
VERDATE | ||
VERSION |
README
The HAProxy documentation has been split into a number of different files for ease of use. Please refer to the following files depending on what you're looking for : - INSTALL for instructions on how to build and install HAProxy - BRANCHES to understand the project's life cycle and what version to use - LICENSE for the project's license - CONTRIBUTING for the process to follow to submit contributions The more detailed documentation is located into the doc/ directory : - doc/intro.txt for a quick introduction on HAProxy - doc/configuration.txt for the configuration's reference manual - doc/lua.txt for the Lua's reference manual - doc/SPOE.txt for how to use the SPOE engine - doc/network-namespaces.txt for how to use network namespaces under Linux - doc/management.txt for the management guide - doc/regression-testing.txt for how to use the regression testing suite - doc/peers.txt for the peers protocol reference - doc/coding-style.txt for how to adopt HAProxy's coding style - doc/internals for developer-specific documentation (not all up to date)