RepoMirrors
/
haproxy
mirror of http://git.haproxy.org/git/haproxy.git/
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
haproxy/reg-tests/README

66 lines
2.4 KiB
Plaintext
Raw Normal View History

REGTEST: Adapt reg test doc files to vtest. This is a first patch to switch from varnishtest to new standalone varnish cache reg testing program: vtest. More information may be found here: https://github.com/vtest/VTest https://varnish-cache.org/docs/trunk/reference/varnishtest.html https://varnish-cache.org/docs/trunk/reference/vtc.html
2019-01-11 09:10:22 +00:00
* Regression testing for HAProxy with VTest *
MINOR: reg-tests: Add reg-tests/README file. Add reg-tests/README file about how to compile and use varnishtest, and how to produce patches to add regression testing files to HAProxy sources. Also update CONTRIBUTING file to encourage the contributors to write regression testing files.
2018-06-19 12:06:07 +00:00
REGTEST: Adapt reg test doc files to vtest. This is a first patch to switch from varnishtest to new standalone varnish cache reg testing program: vtest. More information may be found here: https://github.com/vtest/VTest https://varnish-cache.org/docs/trunk/reference/varnishtest.html https://varnish-cache.org/docs/trunk/reference/vtc.html
2019-01-11 09:10:22 +00:00
This little README file is about how to compile and run vtest test case files (VTC files)
to test HAProxy for any regression.
MINOR: reg-tests: Add reg-tests/README file. Add reg-tests/README file about how to compile and use varnishtest, and how to produce patches to add regression testing files to HAProxy sources. Also update CONTRIBUTING file to encourage the contributors to write regression testing files.
2018-06-19 12:06:07 +00:00
REGTEST: Adapt reg test doc files to vtest. This is a first patch to switch from varnishtest to new standalone varnish cache reg testing program: vtest. More information may be found here: https://github.com/vtest/VTest https://varnish-cache.org/docs/trunk/reference/varnishtest.html https://varnish-cache.org/docs/trunk/reference/vtc.html
2019-01-11 09:10:22 +00:00
To do so, you will have to compile vtest program sources which depends on
Varnish cache application sources. vtest, formerly varnishtest, is a very useful
program which has been developed to test Varnish cache application. vtest has been
modified in collaboration with Varnish cache conceptor Poul-Henning Kamp to support
HAProxy in addition to Varnish cache.
MINOR: reg-tests: Add reg-tests/README file. Add reg-tests/README file about how to compile and use varnishtest, and how to produce patches to add regression testing files to HAProxy sources. Also update CONTRIBUTING file to encourage the contributors to write regression testing files.
2018-06-19 12:06:07 +00:00
REGTEST: Adapt reg test doc files to vtest. This is a first patch to switch from varnishtest to new standalone varnish cache reg testing program: vtest. More information may be found here: https://github.com/vtest/VTest https://varnish-cache.org/docs/trunk/reference/varnishtest.html https://varnish-cache.org/docs/trunk/reference/vtc.html
2019-01-11 09:10:22 +00:00
See also: doc/regression-testing.txt
MINOR: reg-tests: Add reg-tests/README file. Add reg-tests/README file about how to compile and use varnishtest, and how to produce patches to add regression testing files to HAProxy sources. Also update CONTRIBUTING file to encourage the contributors to write regression testing files.
2018-06-19 12:06:07 +00:00
REGTEST: Adapt reg test doc files to vtest. This is a first patch to switch from varnishtest to new standalone varnish cache reg testing program: vtest. More information may be found here: https://github.com/vtest/VTest https://varnish-cache.org/docs/trunk/reference/varnishtest.html https://varnish-cache.org/docs/trunk/reference/vtc.html
2019-01-11 09:10:22 +00:00
* vtest compilation *
MINOR: reg-tests: Add reg-tests/README file. Add reg-tests/README file about how to compile and use varnishtest, and how to produce patches to add regression testing files to HAProxy sources. Also update CONTRIBUTING file to encourage the contributors to write regression testing files.
2018-06-19 12:06:07 +00:00
REGTEST: Adapt reg test doc files to vtest. This is a first patch to switch from varnishtest to new standalone varnish cache reg testing program: vtest. More information may be found here: https://github.com/vtest/VTest https://varnish-cache.org/docs/trunk/reference/varnishtest.html https://varnish-cache.org/docs/trunk/reference/vtc.html
2019-01-11 09:10:22 +00:00
$ git clone https://github.com/vtest/VTest
MINOR: reg-tests: Add reg-tests/README file. Add reg-tests/README file about how to compile and use varnishtest, and how to produce patches to add regression testing files to HAProxy sources. Also update CONTRIBUTING file to encourage the contributors to write regression testing files.
2018-06-19 12:06:07 +00:00
REGTEST: Adapt reg test doc files to vtest. This is a first patch to switch from varnishtest to new standalone varnish cache reg testing program: vtest. More information may be found here: https://github.com/vtest/VTest https://varnish-cache.org/docs/trunk/reference/varnishtest.html https://varnish-cache.org/docs/trunk/reference/vtc.html
2019-01-11 09:10:22 +00:00
$ cd VTest
MINOR: reg-tests: Add reg-tests/README file. Add reg-tests/README file about how to compile and use varnishtest, and how to produce patches to add regression testing files to HAProxy sources. Also update CONTRIBUTING file to encourage the contributors to write regression testing files.
2018-06-19 12:06:07 +00:00
REGTEST: Adapt reg test doc files to vtest. This is a first patch to switch from varnishtest to new standalone varnish cache reg testing program: vtest. More information may be found here: https://github.com/vtest/VTest https://varnish-cache.org/docs/trunk/reference/varnishtest.html https://varnish-cache.org/docs/trunk/reference/vtc.html
2019-01-11 09:10:22 +00:00
$ make vtest
MINOR: reg-tests: Add reg-tests/README file. Add reg-tests/README file about how to compile and use varnishtest, and how to produce patches to add regression testing files to HAProxy sources. Also update CONTRIBUTING file to encourage the contributors to write regression testing files.
2018-06-19 12:06:07 +00:00
REGTEST: Adapt reg test doc files to vtest. This is a first patch to switch from varnishtest to new standalone varnish cache reg testing program: vtest. More information may be found here: https://github.com/vtest/VTest https://varnish-cache.org/docs/trunk/reference/varnishtest.html https://varnish-cache.org/docs/trunk/reference/vtc.html
2019-01-11 09:10:22 +00:00
Then vtest program may be found at the root directory of vtest sources directory.
The Varnish cache manuals are located in 'man' directory of Varnish cache sources
directory. You will have to have a look at varnishtest(7) and vtc(7) manuals to
use vtest.
MINOR: reg-tests: Add reg-tests/README file. Add reg-tests/README file about how to compile and use varnishtest, and how to produce patches to add regression testing files to HAProxy sources. Also update CONTRIBUTING file to encourage the contributors to write regression testing files.
2018-06-19 12:06:07 +00:00
Some information may also be found in doc/regression-testing.txt in HAProxy
sources.
REGTEST: Adapt reg test doc files to vtest. This is a first patch to switch from varnishtest to new standalone varnish cache reg testing program: vtest. More information may be found here: https://github.com/vtest/VTest https://varnish-cache.org/docs/trunk/reference/varnishtest.html https://varnish-cache.org/docs/trunk/reference/vtc.html
2019-01-11 09:10:22 +00:00
Note that VTC files for Varnish cache may be found in bin/varnishtest/tests directory
of Varnish cache sources directory which may be found here:
https://github.com/varnishcache/varnish-cache
MINOR: reg-tests: Add reg-tests/README file. Add reg-tests/README file about how to compile and use varnishtest, and how to produce patches to add regression testing files to HAProxy sources. Also update CONTRIBUTING file to encourage the contributors to write regression testing files.
2018-06-19 12:06:07 +00:00
REGTEST: Adapt reg test doc files to vtest. This is a first patch to switch from varnishtest to new standalone varnish cache reg testing program: vtest. More information may be found here: https://github.com/vtest/VTest https://varnish-cache.org/docs/trunk/reference/varnishtest.html https://varnish-cache.org/docs/trunk/reference/vtc.html
2019-01-11 09:10:22 +00:00
* vtest execution *
MINOR: reg-tests: Add reg-tests/README file. Add reg-tests/README file about how to compile and use varnishtest, and how to produce patches to add regression testing files to HAProxy sources. Also update CONTRIBUTING file to encourage the contributors to write regression testing files.
2018-06-19 12:06:07 +00:00
You must set HAPROXY_PROGRAM environment variable to give the location
REGTEST: Adapt reg test doc files to vtest. This is a first patch to switch from varnishtest to new standalone varnish cache reg testing program: vtest. More information may be found here: https://github.com/vtest/VTest https://varnish-cache.org/docs/trunk/reference/varnishtest.html https://varnish-cache.org/docs/trunk/reference/vtc.html
2019-01-11 09:10:22 +00:00
of the HAProxy program to test to vtest:
MINOR: reg-tests: Add reg-tests/README file. Add reg-tests/README file about how to compile and use varnishtest, and how to produce patches to add regression testing files to HAProxy sources. Also update CONTRIBUTING file to encourage the contributors to write regression testing files.
2018-06-19 12:06:07 +00:00
REGTEST: Adapt reg test doc files to vtest. This is a first patch to switch from varnishtest to new standalone varnish cache reg testing program: vtest. More information may be found here: https://github.com/vtest/VTest https://varnish-cache.org/docs/trunk/reference/varnishtest.html https://varnish-cache.org/docs/trunk/reference/vtc.html
2019-01-11 09:10:22 +00:00
$ HAPROXY_PROGRAM=<my haproxy program> vtest [-Dno-htx=] ...
MINOR: reg-tests: Add reg-tests/README file. Add reg-tests/README file about how to compile and use varnishtest, and how to produce patches to add regression testing files to HAProxy sources. Also update CONTRIBUTING file to encourage the contributors to write regression testing files.
2018-06-19 12:06:07 +00:00
The HAProxy VTC files found in HAProxy sources may be run with the reg-tests
REGTEST: Adapt reg test doc files to vtest. This is a first patch to switch from varnishtest to new standalone varnish cache reg testing program: vtest. More information may be found here: https://github.com/vtest/VTest https://varnish-cache.org/docs/trunk/reference/varnishtest.html https://varnish-cache.org/docs/trunk/reference/vtc.html
2019-01-11 09:10:22 +00:00
Makefile target. You must set the VTEST_PROGRAM environment variable to
give the location of the vtest program which has been previously compiled.
MINOR: reg-tests: Add reg-tests/README file. Add reg-tests/README file about how to compile and use varnishtest, and how to produce patches to add regression testing files to HAProxy sources. Also update CONTRIBUTING file to encourage the contributors to write regression testing files.
2018-06-19 12:06:07 +00:00
REGTEST: Adapt reg test doc files to vtest. This is a first patch to switch from varnishtest to new standalone varnish cache reg testing program: vtest. More information may be found here: https://github.com/vtest/VTest https://varnish-cache.org/docs/trunk/reference/varnishtest.html https://varnish-cache.org/docs/trunk/reference/vtc.html
2019-01-11 09:10:22 +00:00
$ VTEST_PROGRAM=<my vtest program> make reg-tests
MINOR: reg-tests: Add reg-tests/README file. Add reg-tests/README file about how to compile and use varnishtest, and how to produce patches to add regression testing files to HAProxy sources. Also update CONTRIBUTING file to encourage the contributors to write regression testing files.
2018-06-19 12:06:07 +00:00
REGTEST: Adapt reg test doc files to vtest. This is a first patch to switch from varnishtest to new standalone varnish cache reg testing program: vtest. More information may be found here: https://github.com/vtest/VTest https://varnish-cache.org/docs/trunk/reference/varnishtest.html https://varnish-cache.org/docs/trunk/reference/vtc.html
2019-01-11 09:10:22 +00:00
"reg-tests" Makefile target run scripts/run-regtest.sh script.
To get more information about this script run it with --help option.
Note that vtest is run with -t10 and -l option. -l option is to keep
keep vtest temporary directory in case of failed test cases. core files
MINOR: reg-tests: Add reg-tests/README file. Add reg-tests/README file about how to compile and use varnishtest, and how to produce patches to add regression testing files to HAProxy sources. Also update CONTRIBUTING file to encourage the contributors to write regression testing files.
2018-06-19 12:06:07 +00:00
may be found in this directory (if enabled by ulimit).
REGTEST: Adapt reg test doc files to vtest. This is a first patch to switch from varnishtest to new standalone varnish cache reg testing program: vtest. More information may be found here: https://github.com/vtest/VTest https://varnish-cache.org/docs/trunk/reference/varnishtest.html https://varnish-cache.org/docs/trunk/reference/vtc.html
2019-01-11 09:10:22 +00:00
* vtest patches for HAProxy VTC files *
MINOR: reg-tests: Add reg-tests/README file. Add reg-tests/README file about how to compile and use varnishtest, and how to produce patches to add regression testing files to HAProxy sources. Also update CONTRIBUTING file to encourage the contributors to write regression testing files.
2018-06-19 12:06:07 +00:00
REGTEST: Adapt reg test doc files to vtest. This is a first patch to switch from varnishtest to new standalone varnish cache reg testing program: vtest. More information may be found here: https://github.com/vtest/VTest https://varnish-cache.org/docs/trunk/reference/varnishtest.html https://varnish-cache.org/docs/trunk/reference/vtc.html
2019-01-11 09:10:22 +00:00
When producing a patch to add a VTC regression testing file to reg-tests directory,
MINOR: reg-tests: Add reg-tests/README file. Add reg-tests/README file about how to compile and use varnishtest, and how to produce patches to add regression testing files to HAProxy sources. Also update CONTRIBUTING file to encourage the contributors to write regression testing files.
2018-06-19 12:06:07 +00:00
please follow these simple rules:
REGTEST: Adapt reg test doc files to vtest. This is a first patch to switch from varnishtest to new standalone varnish cache reg testing program: vtest. More information may be found here: https://github.com/vtest/VTest https://varnish-cache.org/docs/trunk/reference/varnishtest.html https://varnish-cache.org/docs/trunk/reference/vtc.html
2019-01-11 09:10:22 +00:00
- If your VTC file needs others files, if possible, use the same basename as that
of the VTC file,
MINOR: reg-tests: Add reg-tests/README file. Add reg-tests/README file about how to compile and use varnishtest, and how to produce patches to add regression testing files to HAProxy sources. Also update CONTRIBUTING file to encourage the contributors to write regression testing files.
2018-06-19 12:06:07 +00:00
- Put these files in a directory with the same name as the code area concerned
by the bug ('peers', 'lua', 'acl' etc).