Arquillian Blog

Since we wrote this post we didn't laze around. Check our latest announcement.

The Arquillian team is proud to announce the 1.0.0.Alpha4 release of the Arquillian Cube Extension component!

What’s included in the Alpha4 release?

Support for Boot2Docker!

If you are using boot2docker there are some parameters that depends on the installation of the boot2docker. For example boot2docker ip is not localhost and may change every time you start a new boot2docker instance. Also every time you start boot2docker copies required certificates to home directory of local machine.

Arquillian Cube offers some automatic mechanisms to use boot2docker in Cube.

Read more about it in the documentation.

Support for unix sockets

With the update to the latest version of Docker-java we now support Docker hosts running on a unix socket.

Auto default serverUri if not configured

The serverUri configuration option is where you define the Uri of Docker server. This configuration option is no longer mandatory and Arquillian Cube will attempt to auto set the values for the simplest use cases.

The default values are:

• Linux unix:///var/run/docker.sock
• Windows https://boot2docker:2376
• MacOS https://boot2docker:2376

Fetch files from running container

Sometimes when the tests has finished and container is stopped you want to inspect some data like container console or getting a file from the container to manual inspecting. In these cases you can configure each container to copy console log or copy a file/s from container to local machine just before container is stopped.

tomcat_default:
  image: tutum/tomcat:7.0
  beforeStop:
    - copy:
      from: /test
      to: /tmp

    - log:
      to: /tmp/container.log

Read more about it in the documentation.

Multi thread container auto start up

When you use the autoStartContainers option Arquillian Cube will sort and arrange for the Docker containers and their linked containers to be started in parallel in the correct order.

Support for Arquillian Standalone mode

Arquillian Cube can now be used without any Arquillian Container, via e.g. the arquillian-junit-standalone artifact. With this configuration you get access to all Cube features that are not related to the Java Container support, like CubeController injection.

What is Arquillian Cube Extension?

With Arquillian Cube you can control the lifecycle of Docker images as part of the test lifecyle, either automatically or manually. This gives you the chance to scale up from a integration/functional test level all the way up to the system test level.

Release details

Component	Arquillian Cube Extension
Version	1.0.0.Alpha4 view tag
Release date	2015-02-25
Released by	Aslak Knutsen
Compiled against	Arquillian Core – 1.1.7.Final

Published artifacts org.arquillian.cube

• org.arquillian.cube » arquillian-cube-api jar javadoc pom
• org.arquillian.cube » arquillian-cube-spi jar javadoc pom
• org.arquillian.cube » arquillian-cube-docker jar javadoc pom
• org.arquillian.cube » docker-server-stub jar javadoc pom
• org.arquillian.cube » arquillian-cube-containerless jar javadoc pom

Release notes and resolved issues 28

Enhancement

• #119 Automatic replacement of boot2docker in env and container
• #108 Automatic resolution of cert path
• #104 Upgrade to Arquillian Core 1.1.7.Final
• #100 Automatic docker server URI resolution
• #99 Add boot2docker URI
• #90 Add operation to get log from container
• #89 Add operation for getting files from container
• #78 boot2docker fails without additional configuration workaround found
• #76 Updates to Arquillian 1.1.6
• #73 ForkJoin autostart containers
• #70 Update docker client to v 0.10.5
• #66 Allow dynamic port binding
• #62 Create an static time await
• #56 Support for unix Socket
• #30 Support Arquillian 'standalone' mode

Bug

• #116 Resolve ~ in certPath to home directory.
• #110 shouldAllowToConnectToRunningContainers stop containers
• #106 log feature causes out of memory exception on the client side
• #88 Sets localhost URI when unix socket used
• #77 Allow to connect to running container is not working
• #69 Retrieve docker image id with regexp.
• #68 Arquillian cube can't retrieve image id from docker server
• #64 Execute tests over docker server address
• #61 Missing documentation of shouldAllowToConnectToRunningContainers
• #52 Execute Test On Remote Docker Host ConnectException: Connection timed out: connect

Documentation

• #113 Update documentation with latest changes

Other

• #80 Remove requirement to specify URL in arquillian config if defined on the user's system

Verify

• #65 Allow to start the same container configuration concurrently

Thanks to the following list of contributors: Alex Soto, Aslak Knutsen, Todd Nine, Ralf Battenfeld, James Netherton, Brunogilbertcrane