Arquillian is a testing framework to develop automated functional, integration and acceptance tests for your Java applications. Arquillian container adapters allow Arquillian to bind to and manage the lifecycle of a runtime. There are two types of Arquillian container adapters for Liberty: Liberty Managed and Liberty Remote.
An Arquillian container adapter (DeployableContainer implementation) that can start and stop a local Liberty process and run tests on it over a remote protocol (effectively in a different JVM). For an introduction to testing microservices with the Arquillian Liberty Managed container and Open Liberty, check out the this guide.
Jakarta EE 9: for Arquillian Liberty Managed container documentation with Jakarta EE 9, click here.
Java EE 8 or below: for Arquillian Liberty Managed container documentation with Java EE 8 or below, click here.
An Arquillian container adapter (DeployableContainer implementation) that can connect and run against a remote (different JVM, different machine) Liberty server and run tests on it over a remote protocol (effectively in a different JVM).
Jakarta EE 9: for Arquillian Liberty Remote container documentation with Jakarta EE 9, click here.
Java EE 8 or below: for Arquillian Liberty Remote container documentation with Java EE 8 or below, click here.
To run tests, you will need to specify the following parameters:
| Parameter | Description |
|---|---|
| runtime | The runtime to use. Specify ol for Open Liberty and wlp for WebSphere Liberty. |
| runtimeVersion | Version of the specified runtime to use. |
For example, to run tests on version 20.0.0.11 of the Open Liberty runtime, use the following command:
mvn verify -Druntime=ol -DruntimeVersion=20.0.0.11