search

OpenLiberty / liberty-arquillian

Arquillian Liberty Managed and Remote containers
Apache License 2.0
11 stars 29 forks source link
arquillian java liberty openliberty testing websphere

readme

Arquillian Liberty Server Containers Maven Central Latest Build Status Maven Central 1.x Build Status 1.x

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.

Arquillian Liberty Managed Container

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, 10 and 11: for Arquillian Liberty Managed container documentation with Jakarta EE 9, 10 and 11, click here.

Java EE 8 or below: for Arquillian Liberty Managed container documentation with Java EE 8 or below, click here.

Arquillian Liberty Remote Container

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, 10 and 11: for Arquillian Liberty Remote container documentation with Jakarta EE 9, 10 and 11, click here.

Java EE 8 or below: for Arquillian Liberty Remote container documentation with Java EE 8 or below, click here.

Testing

To run tests, you will need to specify the following parameters:

Parameter Description
runtime The runtime to use. Specify ol for Open Liberty, olbeta for Open Liberty beta, and wlp-ee9 or wlp-ee10 for WebSphere Liberty.
runtimeVersion Version of the specified runtime to use.

For example, to run tests on version 22.0.0.6 of the Open Liberty runtime, use the following command:

mvn verify -Druntime=ol -DruntimeVersion=22.0.0.6

EE 9 archive images are no longer published for WebSphere Liberty so runtimeVersion is ignored for wlp-ee9 and 23.0.0.2 is used which is the last version of the wlp-jakartaee9 archive that was published.