Skip to content

Latest commit

 

History

History
81 lines (62 loc) · 3.8 KB

README.md

File metadata and controls

81 lines (62 loc) · 3.8 KB
Raw

Broker-QE Java System Tests

Warning: This project is still under heavy development

Test suite for standalone and operator-based deployments of ActiveMQ Artemis.

  • Standalone test suite (codename Phoebe) is based on test-containers for testing of Apache Artemis broker.
  • Operator test suite (codename Claire), uses fabric8 java client, which exercises ArtemisCloud deployment on Kubernetes-based platforms.

Prerequisites

To be able to successfully build whole project, you need to have pre-built CRDs for ArtemisCloud project. This can be easily done using crd-jar-maker project. Once this is installed into your local m2/maven repository, following issue should disappear. Could not resolve dependencies for project io.brokerqe:operator-suite:jar:0.1-SNAPSHOT: io.brokerqe:artemiscloud-crd:jar

How to build project and run tests

Use makefile targets to build project using following command (when prerequisite is satisfied) from project-root/Makefile file.

make build

This will build whole project for you.

How to run tests

For detailed instructions please see README.md file for standalone-suite and operator-suite. They contain more details about their specifics.

To quickly execute SmokeTests for each test suite, after building of project execute

make standalone_test_smoke
make operator_test_smoke

If you would like to execute all tests execute following command.

make standalone_test
make operator_test

If you would like to start only some tests, set TESTS environment variable, which is passed as -Dtest=<TESTS> argument into maven. Execute same command as above.

How to build container image

To build container image executed the command:

make -f Makefile.downstream container_build

once the image is built you can push it to quay.io:

podman login --username you_user_name https://quay.io
make -f Makefile.downstream container_push

To execute the tests using the container you can use the command:

operator-suite/container/scripts/run-test.sh --make-envvar OLM=true --image-tag amq-broker-lpt

You may check the run-test.sh help with:

operator-suite/container/scripts/run-test.sh --help

List of shared Environment Variables

Name Description Default Possible values
ARTEMIS_VERSION ArtemisCloud Version to be used (Makefile) 7.10.2 <major>.<minor>.<micro>
ARTEMIS_TEST_VERSION ArtemisCloud Version to be used by tests not set <major>.<minor>
LOGS_LOCATION Location where to generate collected logs test-logs <directory>
TEST_LOG_LEVEL Set logging level of test suite INFO set in logback.xml TRACE, DEBUG, INFO, WARN, ERROR, OFF
COLLECT_TEST_DATA Whether to gather test data on error or not true true, false
TESTS Which tests to execute (maven syntax) not set

More information

For more information about subprojects - refer to README.md files in operator-suite or standalone-suite folders, which contain more details about usage, more environment variables, etc.

Hints

  • keep code clean