Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/openliberty/liberty-arquillian
Arquillian Liberty Managed and Remote containers
https://github.com/openliberty/liberty-arquillian
arquillian java liberty openliberty testing websphere
Last synced: 2 days ago
JSON representation
Arquillian Liberty Managed and Remote containers
- Host: GitHub
- URL: https://github.com/openliberty/liberty-arquillian
- Owner: OpenLiberty
- License: apache-2.0
- Created: 2018-04-16T19:08:32.000Z (over 6 years ago)
- Default Branch: main
- Last Pushed: 2024-10-15T14:55:49.000Z (3 months ago)
- Last Synced: 2024-12-27T02:09:34.156Z (9 days ago)
- Topics: arquillian, java, liberty, openliberty, testing, websphere
- Language: Java
- Homepage:
- Size: 590 KB
- Stars: 11
- Watchers: 6
- Forks: 29
- Open Issues: 22
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Arquillian Liberty Server Containers [](http://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22io.openliberty.arquillian%22%20AND%20a%3A%22arquillian-parent-liberty-jakarta%22) [](https://github.com/OpenLiberty/liberty-arquillian/actions?branch=main) [](http://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22io.openliberty.arquillian%22%20AND%20a%3A%22arquillian-parent-liberty%22) [](https://github.com/OpenLiberty/liberty-arquillian/actions?branch=1.x-maintenance)
[Arquillian](http://arquillian.org/) 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](#Arquillian-Liberty-Managed-Container) and [Liberty Remote](#Arquillian-Liberty-Remote-Container).
### 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](https://openliberty.io/), check out the [this guide](https://openliberty.io/guides/arquillian-managed.html).
**Jakarta EE 9, 10 and 11:** for Arquillian Liberty Managed container documentation with Jakarta EE 9, 10 and 11, click [here](liberty-managed/JakartaEE9_README.md).
**Java EE 8 or below:** for Arquillian Liberty Managed container documentation with Java EE 8 or below, click [here](liberty-managed/README.md).
### 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](liberty-remote/JakartaEE9_README.md).
**Java EE 8 or below:** for Arquillian Liberty Remote container documentation with Java EE 8 or below, click [here](liberty-remote/README.md).
### 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.