Improve your Java Environment with Docker

Improve your Java development env with

DOCKERCompose & Machine

Copyright 2015 eXo Platform

About Us


● Maxime Gréau○ @mgreau

● Software Engineer at eXo

● Thomas Delhoménie○ @tdelhomenie

● Software Engineer at eXo

Agenda


1. Docker Toolbox2. Work on multiple technical stacks3. Uses cases “In A Container”

3.1. Debug3.2. Code & Deploy 3.3. Deploy from your IDE 3.4. Build & Run with Maven Docker Plugins3.5. Integration Tests

4. Reproduce production bugs easily5. Work with an architecture closest to production6. Do all the things with Docker & co

What’s the

PROBLEMwith my development environment?


Problem 1: Dev environment setup time


Welcome, it’s your first day, you just have to:

● Install Maven 3.2.3

● Install JDK 1.7.0_80

● Install Tomcat 7.0.63

● Install MySQL 5.5, PostgreSQL 9.1

● Read the installation doc…

The BIG installation doc !


And after 1 hour....

Problem 2: Works on my machine


Problem 3: the matrix hell


MySQL 5.1 MySQL 5.5 Mongo 3.0 Java 7 Java 8

My first app v1 X X

My first app v2 X X X X

My other app v1 X X

...

Fix all those problems with 3 commands!


Pre-requisites

docker, machine & compose installed

Then

1. Run git clone https://github.com/my-repo/my.git & cd my-project

2. Run docker-compose up

3. Open your browser

https://github.com/my-repo/my-project.git

Docker

TOOLBOXFor OSX and Windows


Docker Toolbox includes...


● Docker Machine for running the docker-machine binary

● Docker Engine for running the docker binary

● Docker Compose for running the docker-compose binary

● Kitematic, the Docker GUI

● Oracle VM VirtualBox

Only for OSX and Windows

Create dev environment


Mac & Windows

> docker-machine create my-machine-name

> eval $(docker-machine env my-machine-name)

Linux

Nothing special to do!

TOURNAMENTSTENNIS APP

Sample Application


Tennis App - Screenshots


batch-tennis-app.warws-tennis-app.war

WildFly 8.2

WildFly 8.2

JSON-P 1.0

CDI 1.1

WebSocket API 1.0

JPA 2.1

Batch API 1.0

Tennis App - Architecture - Java EE 7


batch-tennis-app.war

MySQL

ws-tennis-app.war

Browser

CSV

As a Developer you want to

Work on multiple technical stacks


WildFly 8.2

Multiple apps with docker compose


MySQL 5.7 Maria DB 10.0

batch-tennis-app.war

Apache

Wordpress

DEMO 1


Application 1

> git clone URL1 & cd app1> mvn package> docker-compose up

open your browser !

Application 2

> git clone URL2 & cd app2> docker-compose up

open your browser !

Tennis App Batch - Dockerfile


FROM jboss/wildfly:8.2.1.Final

RUN mkdir -p /opt/jboss/wildfly/standalone/deployments/ROOT.war/RUN touch /opt/jboss/wildfly/standalone/deployments/ROOT.war.dodeploy

VOLUME ["/opt/jboss/wildfly/standalone/deployments/ROOT.war/"]

ENV MYSQL_CONNECTOR_VERSION 5.1.34

RUN /opt/jboss/wildfly/bin/add-user.sh -up mgmt-users.properties admin Admin#70365 --silent

# Install mysql driverRUN curl -L -o /opt/jboss/wildfly/standalone/deployments/mysql-connector-java.jar https://repo1.maven.org/maven2/mysql/mysql-connector-java/${MYSQL_CONNECTOR_VERSION}/mysql-connector-java-${MYSQL_CONNECTOR_VERSION}.jar

CMD ["/opt/jboss/wildfly/bin/standalone.sh", "-b", "0.0.0.0"]

Tennis App Batch - docker-compose.yml


batch_run:build: ./docker/dev/run/backendports:

- "7777:8080"volumes:

- ./app/batch/target/batch:/opt/jboss/wildfly/standalone/deployments/ROOT.war/links:

- dbdbdata:

image: mysql:5.7volumes:

- /var/lib/mysqldb:

image: mysql:5.7volumes_from:

- dbdataenvironment:

- MYSQL_ROOT_PASSWORD=tennistour - MYSQL_DATABASE=tennistour - MYSQL_USER=tennistour- MYSQL_PASSWORD=tennistour

PHP Application - Dockerfile (Wordpress)


FROM php:5.6-apache

RUN a2enmod rewrite

# install the PHP extensions we needRUN apt-get update && apt-get install -y libpng12-dev libjpeg-dev && rm -rf /var/lib/apt/lists/* \

&& docker-php-ext-configure gd --with-png-dir=/usr --with-jpeg-dir=/usr \&& docker-php-ext-install gd

RUN docker-php-ext-install mysqli

VOLUME /var/www/html

ENV WORDPRESS_VERSION 4.3.1ENV WORDPRESS_SHA1 b2e5652a6d2333cabe7b37459362a3e5b8b66221

# upstream tarballs include ./wordpress/ so this gives us /usr/src/wordpressRUN curl -o wordpress.tar.gz -SL https://wordpress.org/wordpress-${WORDPRESS_VERSION}.tar.gz \

&& echo "$WORDPRESS_SHA1 *wordpress.tar.gz" | sha1sum -c - \&& tar -xzf wordpress.tar.gz -C /usr/src/ \&& rm wordpress.tar.gz \&& chown -R www-data:www-data /usr/src/wordpress

COPY docker-entrypoint.sh /entrypoint.sh

# grr, ENTRYPOINT resets CMD nowENTRYPOINT ["/entrypoint.sh"]CMD ["apache2-foreground"]

PHP Application - docker-compose.yml


wordpress:image: wordpress

links:- db:mysql

ports:- 8080:80

db:image: mariadbenvironment:

MYSQL_ROOT_PASSWORD: example

Others use cases


eXo use case : multi databases support (matrix compatibility pb)

PostgreSQL 9.3MySQL 5.6MySQL 5.5 PostgreSQL

9.4Oracle 11gR2

Others use cases


Migration between 2 versions of the database

my-app

MySQL 5.5

my-app

MySQL 5.7


USE CASES“In a Container”


Debug Java app in a container


How to debug in a container ?


WildFly 8.2

MySQL 5.7

batch-tennis-app.warRemote debug

DEMO 2



Code and deploy


How to deploy a new war ?


● Update your code in your favorite IDE

● Build with maven

● Open your browser !

DEMO 3



Use your IDE to deploy in a container


IDE starts to support Docker container technology


● Eclipse Mars (2015)

● Netbeans

● IntelliJ IDEA v14.1


Build & Run with Maven Docker plugins


Docker Maven plugins


mvn tomcat:run

https://github.com/rhuss/docker-maven-plugin

mvn docker:start


Execute Integration Tests in containers


Arquillian - Intro


● Automated tests without mocks

● Compatible JUnit/TestNG

● Application Server agnostic

● Embedded/Managed/Client modes

Arquillian Cube


http://arquillian.org/modules/cube-extension/

Shameless auto-promotion :http://mgreau.com/posts/2015/03/03/docker-asciidoctorj-wildfly-arquillian.html



http://mgreau.com/posts/2015/03/03/docker-asciidoctorj-wildfly-arquillian.html




Easily reproduce production bugs


Test with the production version of the “old” stack


my-app

MySQL 5.5

my-app

MySQL 5.7

> git checkout v1> “build”> docker-compose up

New dev stackProd stack

5.5 5.7

v1 v2


Work with an architecture close to production


Angular / Java EE 7 Application


Apache HTTPD

UIAngular

Load Balancer

WildFly 8.2

WildFly 8.2

batch-tennis-app.war MySQL

ws-tennis-app.war

Cache Redis

CSV

WildFly 8.2

ws-tennis-app.war

WildFly 8.2

ws-tennis-app.war

DEMO 4


DO ALL THE THINGS WITH DOCKER


Build your projects with docker


You will only need docker tools

on your laptop!

DEMO 5


Docker

TOOLS


GUI for Docker


● Kitematic

● DockerUI

Docker

BEST PRACTICES


Some best practices for development


● Use Docker Machine to organize your images and limit resources usage

(CPU, memory, …)

● Use volume containers to keep your data safe (schema)

● Useful docker commands:

○ stopped docker containers : docker stop $(docker ps -q)

○ remove dangling docker images:

■ docker rmi $(docker images -q -f "dangling=true")

○ and more: https://github.com/javaee-samples/docker-

java/blob/master/chapters/docker-commands.adoc

https://github.com/javaee-samples/docker-java/blob/master/chapters/docker-commands.adoc




Docker doesn’t invent the container technology,

BUT

make it possible to use it easily on your laptop!

Improve your Java development env withDocker Compose & Machine

Thanks@tdelhomenie @mgreau

Code: http://github.com/mgreau/docker4dev-tennistour-app

https://twitter.com/tdelhomenie

http://twitter.com/mgreau

https://twitter.com/tdelhomenie

http://github.com/mgreau/docker4dev-tennistour-app