Tech Tip #61 showed how to run Java EE 7 Hands-on Lab using Docker. The Dockerfile used there can be used to create a new image that can deploy any Java EE 7 WAR file to the WildFly instance running in the container.

For example github.com/arun-gupta/docker-images/blob/master/javaee7-test/Dockerfile can be copied to the root directory of javaee7-samples and be used to deploy jaxrs-client.war file to the container. Of course, you first need to build the sample as:

The exact Dockerfile is shown here:

If you want to deploy another Java EE 7 application, then you need to do the following steps:

• Create the WAR file of the sample
• Change the Dockerfile
• Build the image
• Stop the previous container
• Start the new container

Now, if you want to run tests against this instance then mvn test alone will not do it because either you need to bind the IP address of the Docker container statically, or dynamically find out the address and then patch it at runtime. Anyway, the repeated cycle is little too cumbersome. How do you solve it?

Meet Arquillian Cube!

Arquillian Cube allows you to control the lifecycle of Docker images as part of the test lifecyle, either automatically or manually.

The blog entry provide more details about getting started with Arquillian Cube, and this functionality has now been enabled in “docker” branch of javaee7-samples. Arquillian Cube Extension Alpha2 was recently released and is used to provide integration. Here are the key concepts:

• A new “wildfly-docker-arquillian” profile is being introduced
• The profile adds a dependency on:
  
  <dependency> <groupId>org.arquillian.cube</groupId> <artifactId>arquillian-cube-docker</artifactId> <version>1.0.0.Alpha2</version> <scope>test</scope> </dependency>

  1 2 3 4 5 6 7 8

  <dependency>     <groupId>org.arquillian.cube</groupId>     <artifactId>arquillian-cube-docker</artifactId>     <version>1.0.0.Alpha2</version>     <scope>test</scope> </dependency>

• Uses Docker REST API to talk to the container. Complete API docs shows the sample payloads and explains the query parameters and status codes.
• Uses WildFly remote adapter to talk to the application server running within the container
• Configuration for Docker image is specified as part of maven-surefire-plugin.:
  
  <configuration> <systemPropertyVariables> <arquillian.launch>wildfly-docker</arquillian.launch> <arq.container.wildfly-docker.configuration.username>admin</arq.container.wildfly-docker.configuration.username> <arq.container.wildfly-docker.configuration.password>Admin#70365</arq.container.wildfly-docker.configuration.password> <arq.extension.docker.serverVersion>1.15</arq.extension.docker.serverVersion> <arq.extension.docker.serverUri>http://127.0.0.1:2375</arq.extension.docker.serverUri> <arq.extension.docker.dockerContainers> wildfly-docker: image: arungupta/javaee7-samples-wildfly exposedPorts: [8080/tcp, 9990/tcp] await: strategy: polling sleepPollingTime: 50000 iterations: 5 portBindings: [8080/tcp, 9990/tcp] </arq.extension.docker.dockerContainers> </systemPropertyVariables> </configuration>

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21

  <configuration>     <systemPropertyVariables>     <arquillian.launch>wildfly-docker</arquillian.launch>     <arq.container.wildfly-docker.configuration.username>admin</arq.container.wildfly-docker.configuration.username>     <arq.container.wildfly-docker.configuration.password>Admin#70365</arq.container.wildfly-docker.configuration.password>     <arq.extension.docker.serverVersion>1.15</arq.extension.docker.serverVersion>     <arq.extension.docker.serverUri>http://127.0.0.1:2375</arq.extension.docker.serverUri>     <arq.extension.docker.dockerContainers>         wildfly-docker:             image: arungupta/javaee7-samples-wildfly             exposedPorts: [8080/tcp, 9990/tcp]             await:                 strategy: polling                 sleepPollingTime: 50000                 iterations: 5             portBindings: [8080/tcp, 9990/tcp]     </arq.extension.docker.dockerContainers>     </systemPropertyVariables> </configuration>

  Username and password are specified are for the WildFly in arungupta/javaee7-samples-wildfly image. All the configuration values can be overridden by arquillian.xml for each test case, as explained here.

How do you try out this functionality?

Here is a complete log of running simple-servlet test:

REST payload from the client to Docker server are shown here. This was verified on a Fedora 20 Virtual Box image. Here are some quick notes on setting it up there:

1. Install the required packages
   
   yum install docker-io git maven yum upgrade selinux-policy

   1 2 3 4

   yum install docker-io git maven yum upgrade selinux-policy

2. Configure Docker
   
   sudo vi /etc/sysconfig/docker Change to "OPTIONS=--selinux-enabled -H tcp://127.0.0.1:2375 -H unix:///var/run/docker.sock" sudo service docker start

   1 2 3 4 5

   sudo vi /etc/sysconfig/docker Change to "OPTIONS=--selinux-enabled -H tcp://127.0.0.1:2375 -H unix:///var/run/docker.sock" sudo service docker start

3. Verify Docker TCP configuration
   
   docker -H tcp://127.0.0.1:2375 version Client version: 1.3.1 Client API version: 1.15 Go version (client): go1.3.3 Git commit (client): 4e9bbfa/1.3.1 OS/Arch (client): linux/amd64 Server version: 1.3.1 Server API version: 1.15 Go version (server): go1.3.3 Git commit (server): 4e9bbfa/1.3.1

   1 2 3 4 5 6 7 8 9 10 11 12 13

   docker -H tcp://127.0.0.1:2375 version   Client version: 1.3.1 Client API version: 1.15 Go version (client): go1.3.3 Git commit (client): 4e9bbfa/1.3.1 OS/Arch (client): linux/amd64 Server version: 1.3.1 Server API version: 1.15 Go version (server): go1.3.3 Git commit (server): 4e9bbfa/1.3.1

Boot2docker on Mac still has issue #49, this is Alpha2 after all

Try some other Java EE 7 tests and file bugs here.

Enjoy!

Be Sociable, Share!

• 

•