httpd integration testing
In this repository there are some prototypes of possible solutions to automate the integration testing of the httpd code.
Docker
The Docker images can be build and executed like the following:
docker build . --build-arg X=foo --build-arg X2=bar .. -t $name-of-the-image
docker run $name-of-the-image $command
The idea for the Docker images is to checkout a httpd branch and the httpd-framework repos in the same place, building and configuring them to be ready to use.
Debian and Ubuntu
Debian and Ubuntu share the same docker image, that must be built with --build_arg image_name=$docker_hub_image_name
with the following possible values:
ubuntu
debian:jessie
debian:stretch
debian:buster
- etc..
CentOS
CentOS 8 doesn't ship with the lua-devel
package, so it needs to be build manually in the Dockerfile.
Release candidate testing
These docker images focus on getting a certain release candidate tarball, unpack/check/configure/build it and allow to run the Perl test suite.
To build the image (example): docker build --build-arg image_name=debian:buster --build-arg httpd_version='2.4.40' --buil-arg trunk_configure_args='--enable-mpms-shared --enable-maintainer-mode ..' --buil-arg=24x_configure_args='--enable-mpms-shared --enable-maintainer-mode ..' . -t debian/buster/httpd-tests-ga
To run the perl test suite: docker run $name-of-the-image /bin/bash -c "cd /tmp/httpd-test && ./t/TEST"
Code snapshot testing
These docker images focus on getting the latest version of the trunk and 2.x.x branches, configure/build them and allow to run the Perl test suite.
To build the image (example): docker build --build-arg image_name=debian:buster --branch trunk --buil-arg configure='--enable-mpms-shared --enable-maintainer-mode ..' . -t debian/buster/httpd-tests-code-snapshot
To run the perl test suite (trunk only, if --with-test-suite=/tmp/httpd-test
is passed to the configure
arg): docker run $name-of-the-image /bin/bash -c "cd /tmp/httpd-trunk && make check
To run the perl test suite (2.4.x): docker run $name-of-the-image /bin/bash -c "cd /tmp/httpd-test && ./t/TEST"
TODOs:
- Add travis configuration.
- Find a way to improve reuse of configurations in Dockerfiles (at the moment there is a lot of repetition).
- Add support for more OSes.