Please refer to instructions at https://github.com/druid-io/docker-druid/blob/master/docker-install.md.
Create a new VM for integration tests with at least 6GB of memory.
docker-machine create --driver virtualbox --virtualbox-memory 6000 integration
Set the docker environment:
eval "$(docker-machine env integration)" export DOCKER_IP=$(docker-machine ip integration)
Make sure that you have at least 6GB of memory available before you run the tests.
To run all the tests using docker and mvn run the following command -
mvn verify -P integration-tests
To run only a single test using mvn run the following command -
mvn verify -P integration-tests -Dit.test=<test_name>
To run tests on any druid cluster that is already running, create a configuration file:
{ "broker_host": "<broker_ip>", "broker_port": "<broker_port>", "router_host": "<router_ip>", "router_port": "<router_port>", "indexer_host": "<indexer_ip>", "indexer_port": "<indexer_port>", "coordinator_host": "<coordinator_ip>", "coordinator_port": "<coordinator_port>", "middle_manager_host": "<middle_manager_ip>", "zookeeper_hosts": "<comma-separated list of zookeeper_ip:zookeeper_port>", }
Set the environment variable CONFIG_FILE to the name of the configuration file -
export CONFIG_FILE=<config file name>
To run all the tests using mvn run the following command -
mvn verify -P int-tests-config-file
To run only a single test using mvn run the following command -
mvn verify -P int-tests-config-file -Dit.test=<test_name>
For every end-user functionality provided by druid we should have an integration-test verifying the correctness.
A test can access different helper and utility classes provided by test-framework in order to access Coordinator,Broker etc.. To mark a test be able to use Guice Dependency Injection - Annotate the test class with the below annotation
@Guice(moduleFactory = DruidTestModuleFactory.class)
This will tell the test framework that the test class needs to be constructed using guice.
Refer ITIndexerTest as an example on how to use dependency Injection