Skip to content
No description, website, or topics provided.
Branch: master
Clone or download
Latest commit c788cde Aug 28, 2015
Type Name Latest commit message Commit time
Failed to load latest commit information.
src/test Initial version Aug 28, 2015
.gitignore Initial version Aug 28, 2015
README.adoc Initial version Aug 28, 2015
pom.xml Initial version Aug 28, 2015
readme.html Initial version Aug 28, 2015


Arquillian Cube Standalone

Usually Arquillian is used to test enterprise applications that are deployed to an application server (or Servlet container like Tomcat).

But you can use Aquillian-Standalone module which effectively skips the deployment phase, so you can use it in diffrent circumstances. In case of Arquillian-Cube, it can be used for writing integration tests of pieces of code that don’t need to be deployed anywhere, but they require to connect to a service exposed via docker.

One example could be writing a test for a client-library that connects to a SSH server. The integration test could boot up a docker image with an SSH server and some users already added. Then simply you can test against a real server that the client connects correctly.

Arquillian Cube dependencies

You only need to add two dependencies to start using Arquillian Cube + Arquillian Standalone, but for this example we have added logger dependencies and a Java SSH client.

  1. Arquillian bom to have all versions aligned.

  2. Arquillian JUnit standalone dependency. Required to avoid deployment.

  3. Arquillian Cube dependency for docker integration.


Next step is to configure Arquillian Cube to start the SSHD image. This is done in arquillian.xml file which is located by default at test-resources} directory.

  1. Extension tag to docker extension.

  2. Since I am using Docker-Machine I need to set the machine’s name.

  3. AutostartContainers is used for setting which container of definition should be started.

  4. Finally the definition of the container that should be start.

Notice that in current definition, we have set that we want to use a Dockerfile definition to build the image by setting buildImage element. Also it is important to notice that the the first element on`dockerContainers` property is the name of the container, which is used in utoStartContainers as well.

Finally we need to create the ockerfile specified in the configuration at src/test/resources/sshd directory.



Finally we can write the test:

  1. Test must be annotated with Arquillian runner.

  2. This test is executed when the container is started and ready to serve petitions.

  3. Now IP should be set manually, in next release the IP will be injected automatically.

You can’t perform that action at this time.