This directory contains integration tests for Pulsar.
The integration tests use a framework called Arquillian Cube to bring up a bunch of docker containers running Pulsar services. TestNG can then be used to test functionallity against these containers.
Arquillian sets up a clean set of containers for each test suite. However, if maven is configured to fork per test class, Arquillian will set up a clean set of containers per test class. The test cases within the class will share the environment, so tests which leave the cluster in a different state after running should be put in their own test class.
The tests require that docker is installed and running. Tests will only run if the integrationTests system property is defined. To run the tests:
# in the top level directory pulsar/ $ mvn install -DskipTests -Pdocker # builds the docker images ... pulsar/ $ mvn -f tests/pom.xml test -DintegrationTests
The directories are as follows: