Arquillian Forge Addon

Setting up an Arquillian profile & Test Framework

Arquillian supports testing in multiple containers. This is done by using a Maven profile for each container. This makes it possible to have multiple containers configured side-by-side too. To add a new profile you use the arquillian setup command:

arquillian-setup

This command will prompt for which testframework to use, do you want to use standalone mode, if not then which container to use.

If you need to install an additional container profile, run command:

arquillian-add-container

In above command if selected container is supported by chameleon then it is configured using chameleon, otherwise it will add required container adapter to setup container.

If container is not supported by chameleon, Forge will download it for you. There is no need to download container manually.

Note: We are no longer supporting container prior to JBoss AS 7 in forge.

Tomcat Container Configuration

In case of Tomcat container, if you are trying to set it up in managed mode. Forge will create custom server.xml depending on tomcat version, tomcat-users.xml which contains users with manager-script role. So after successful execution of command, chameleon is configured with required resources & properties, Tomcat is ready to use. No worries about configuration.

It will only work if catalina.home is nested in the target folder.(For chameleon default download folder for container distributions is target/ for Maven).

Generating tests

Writing Arquillian tests is trivial, and is documented well: https://docs.jboss.org/author/display/ARQ/Reference+Guide

Forge can help you get started however.

arquillian-create-test --targets demo.CoolBean --archiveType JAR

Of course you can use the TAB key to navigate to the class that you want to test.

Arquillian Cube

Setup:

To add Arquillian Cube dependencies configuration options in arquillian.xml, run command:

arquillian-cube-setup --type docker-compose --file-path docker-compose.yml

Before running above command make sure that file provided with file-path is exists.

Create Test:

To create a test class, run command:

arquillian-create-test --named MyDockerComposeTest --target-package org.arquillian.cube.

Add Cube Test & Enrichers:

To enrich a given Arquillian test with respective annotations depending on selected type, run command:

arquillian-cube-add-test --test-class org.cube.docker.MyDockerComposeTest

Same way you can create a test for Kubernetes, Docker, Openshift.

All Available Commands

Name	Usage
arquillian-setup	To setup container, and add test framework dependency.
arquillian-add	To add arquillian universe bom dependency
arquillian-add-testframework	To add testframework dependency.
arquillian-container-setup	To add required dependency for container to setup.
arquillian-container-configuration	To configure container configuration.
arquillian-create-test	To create a test inside package.
arquillian-cube-setup	To add arquillian cube dependency & updates arquillian configuration.
arquillian-cube-add-test	To add a test method in selected class with required test enricher depending on selected type.

For more details about options have a look into integration tests at: integration tests