Arquillian Guides Designed exclusively to teach you how to use Arquillian to write real tests.

Assumptions

We’ll assume that you’ve read the Getting Started guide and the Functional Testing. This tutorial builds on the applications you built in those tutorials.

We’ll show you how to get a free OpenShift Express account, set up an application that uses the JBoss AS 7 cartridge and run the tests in that environment.

Whenever we refer to OpenShift in this guide, we are referring specifically to OpenShift Express. OpenShift Express is free, but does not include auto-scaling, so it’s ideally suited for development.

In this guide, we’ll be using the following technologies:

• OpenShift Express
• Arquillian OpenShift Container

Create an OpenShift Express Account

1. Go to http://openshift.redhat.com
2. Click on “Sign up and try it” button
3. Fill in the form and follow the instructions in the welcome mail

Setup OpenShift Express

You can now sign-in into OpenShift with your credentials. We will be using OpenShift Express, so click on “Express”. OpenShift Express is usually managed with client tools, but their use in this tutorial is optional as we can create an app from the OpenShift Express Web Console. Refer to the OpenShift website for additional documentation and tutorials about using OpenShift.

You need to follow these steps to create your app using the web console. Skip to the next part if you prefer to use the command line client tools.

OpenShift Express uses git over SSH to upload your application. You can use your existing SSH key, which can be found by in ~/.ssh/id_rsa.pub on most GNU/Linux systems by default. You can generate an SSH keypair with ssh-keygen command.

$ ssh-keygen

The output should look like this

Generating public/private rsa key pair.
Enter file in which to save the key (/home/foobar/.ssh/id_rsa):  
Created directory '/home/foobar/.ssh'.
Enter passphrase (empty for no passphrase): 
Enter same passphrase again: 
Your identification has been saved in /home/foobar/.ssh/id_rsa.
Your public key has been saved in /home/foobar/.ssh/id_rsa.pub.
The key fingerprint is:
3f:91:5e:01:ab:e8:15:b3:6c:0b:20:7e:5d:64:5a:2e foobar@example

You can now find your public key in the ~/.ssh/id_rsa.pub file.

You may now login into OpenShift and open the Express Console and follow these steps to create your first app:

1. Upload Your SSH public key.
2. Choose a namespace. You may have multiple apps running in your OpenShift Express account, all in one namespace. Our OpenShift Express applications will be available on URI in the form http://app-namespace.rhcloud.com.
3. Create an app, choose jbossas-7.0 as its type. We have chosen test as its name in this example:

You can now try to go to the URL of the app in your web browser, you should see a page with the message “Welcome to OpenShift, JBossAS7 Cartridge”. You can now skip to creating an OpenShift Express Maven profile.

Use the OpenShift Client Tools

First you have to install the client tools. Follow the OpenShift documentation for the specific instructions for Your platform.

Next you have to choose your namespace. This will be the namespace which will be part of the URL of all your applications. Change ikecloud for your chosen namespace and foobar@example.com for your login in the following command, you will be asked for your OpenShift password.

$ rhc-create-domain -n ikecloud -l foobar@example.com

You might get an error if your chosen namespace has already been taken.

The rhc-create-domain will create an SSH keypair and also update your ~/.openshift/express.conf file so you won’t have to specify your login on further commands.

Now you can create an application.

$ rhc-create-app -a test -t jbossas-7.0

You should be seeing something like this:

Password: 
Creating application: test
Now your new domain name is being propagated worldwide (this might take a minute)...
Warning: Permanently added 'test-ikecloud.rhcloud.com,107.22.54.121' (RSA) to the list of known hosts.
Confirming application 'test' is available:  Success!

test published:  http://test-ikecloud.rhcloud.com/
git url:  ssh://bf0e04dea4b946d89c55283a0dd4136e@test-ikecloud.rhcloud.com/~/git/test.git/
Successfully created application: test

The app has now been created and its sources are available via git on the “git url”. The command has also cloned the git repository into test directory in your current working directory. You can now modify your local copy and use “git push” to deploy the new version into the cloud. We will not do that in this tutorial, as we will just use the OpenShift Express as a test container for our existing application.

Create an OpenShift Express Profile

Add another entry to the dependency management section defining version of the Arquillian OpenShift Express container adapter.

<!-- clip -->
<dependencyManagement>
    <dependency>
        <groupId>org.jboss.arquillian.container</groupId>
        <artifactId>arquillian-openshift-express</artifactId>
        <version>1.0.0.Alpha1</version>
        <scope>test</scope>
    </dependency>
</dependencyManagement>
<!-- clip -->

Next create a new profile with the id arquillian-openshift-express.

<!-- clip -->
<profile>
    <id>arquillian-openshift-express</id>
    <dependencies>
        <dependency>
            <groupId>org.jboss.spec</groupId>
            <artifactId>jboss-javaee-6.0</artifactId>
            <version>1.0.0.Final</version>
            <type>pom</type>
            <scope>provided</scope>
        </dependency>

        <dependency>
            <groupId>org.jboss.arquillian.container</groupId>
            <artifactId>arquillian-openshift-express</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>
</profile>
<!-- clip -->

Configure the arquillian.xml, enter your own values. The sshUserName can be found in the Repository URL in the Express Console, e.g. ssh:// 4348a6ba9d3943e6a64e0a1607b37bd5 @test-ikecloud.rhcloud.com/~/git/test.git/

<!-- clip -->
<container qualifier="openshift-express">
    <configuration>
        <property name="namespace">ikecloud</property>
        <property name="application">test</property>
        <property name="sshUserName">4348a6ba9d3943e6a64e0a1607b37bd5</property>
        <property name="passphrase">Password</property>
        <property name="login">foobar@example.com</property>
    </configuration>
</container>
<!-- clip -->

You can also set the passphrase via SSH_PASSPHRASE environment variable.

You can now test in the cloud by executing the following command:

$ mvn test -Parquillian-openshift-express -Darquillian.launch=openshift-express

We can also make the openshift-express the default container, configure the openshift-express as the active profile in Eclipse and run the test from Eclipse the same way as we did in the previous tutorial. Green bar!

Hey, look, Ike is on OpenShift!

Share the Knowledge

Find this guide useful?

There’s a lot more about Arquillian to cover. If you’re ready to learn more, check out the other available guides.

Feedback

Find a bug in the guide? Something missing? You can fix it by forking this website, making the correction and sending a pull request. If you’re just plain stuck, feel free to ask a question in the user discussion forum.

Recent Changelog

• Sep 21, 2017: Fix(scripts) timeout for waiting for timestamp available on pages is by Matous Jobanek

See full history »