JVM microservices – JVM based application as Docker container

Evgeny ShepelyukDecember 22nd, 2015Last Updated: December 22nd, 2015

0 29 3 minutes read

Continuation of Windows and Docker integration guide. The goal of this post is to show quick and easy way of creating new JVM project and run it as a Docker container on Windows.

In the previous post I’ve described how to setup Docker environment on Windows powered PC and run existing Docker container. Now it’s time to create own JVM project, create Docker image and run it.

When it comes to quickly prototype something on JVM platform – Groovy is a great language choice. Furthermore, using Groovy in this guide is a perfect example of Docker powered JVM microservices polyglot nature. For a build tool my natural choice is Gradle, that will be used in this guide as well.

Setup Gradle using sdkman

Gradle can be installed and added to PATH manually, but there exists sdkman tool that drastically simplifies installation of Gradle and other utilities. So, I’d suggest to spend some minutes to setup it and use for Gradle installation.

First of all unzip should be installed, since it is required for sdkman installer. In new bash console execute.
```
$ pacman -S unzip
```

Then install sdkman.

$ export SDKMAN_DIR="$HOME/.sdkman" && curl -s get.sdkman.io | bash

After the installation there can be issues running sdkman in msys2 environment. The reason is explained in corresponding GitHub Issue
1. To fix it open file ~/.sdkman/bin/sdkman-init.sh and find the line.
```
if [[ -n "${CANDIDATE_NAME}" && -h "${CANDIDATE_DIR}" ]]; then
```
2. Replace it with.
```
if [[ -n "${CANDIDATE_NAME}" && -d "${CANDIDATE_DIR}" ]]; then
```
Now sdkman is ready, open new bash console and install latest Gradle version.
```
$ sdk install gradle
```

Check that Gradle was installed correctly (may require opening new bash).

$ gradle --version

------------------------------------------------------------
Gradle 2.9
------------------------------------------------------------

Build time:   2015-11-17 07:02:17 UTC
Build number: none
Revision:     b463d7980c40d44c4657dc80025275b84a29e31f

Groovy:       2.4.4
Ant:          Apache Ant(TM) version 1.9.3 compiled on December 23 2013
JVM:          1.8.0_45 (Oracle Corporation 25.45-b02)
OS:           Windows 8.1 6.3 amd64

Sample Groovy application

Project folder structure can be generated by running Gradle task.
```
$ gradle init --type groovy-library
```
After generation Library.groovy and LibraryTest.groovy could be removed.
Create main application class.ua.eshepelyuk.blog.Hello.groovy
```
package ua.eshepelyuk.blog

println "Hello from Docker by Groovy and Gradle" (1)
```
(1) declaration of public static void main could be omitted in Groovy
Although gradle init generates Gradle wrapper scripts, I won’t use them in this guide. For real-life projects I’d suggest to use wrapper and don’t rely on local Gradle installation.
Enable Docker support for project build script
When using Gradle you don’t need to deal with Dockerfile and other things for creating Docker image. There’re plugins for this :))
To enable and customize them just add some lines to build.gradle as described below.
Enable plugins
build.gradle
```
plugins {
    id 'groovy'
    id 'application' (1)
    id 'com.bmuschko.docker-java-application' version '2.6.1' (2)
}
```
(1) Plugin for building runnable application that can be embedded into Docker image
(2) Docker support plugin
Customize plugins
build.gradle
```
mainClassName = 'ua.eshepelyuk.blog.Hello' (1)

docker {
    url = System.env.DOCKER_HOST.replaceAll("tcp", "https") (2)
    javaApplication {
        tag = "eshepelyuk/hellodockergradle:latest" (3)
    }
}
```
(1) Entry point for application plugin
(2) Fixing docker machine URL for Java API
(3) Docker image tag name
Build image and run Docker container
Must run start.sh script from Docker for windows installation before proceed to further steps. Please refer to previous post for details.
1. Execute command to create Docker image.
```
$ gradle dockerBuildImage
```
2. Check new image is available by running docker image. Command output should include new image tagged with eshepelyuk/hellodockergradle (setting from build.gradle).
```
$ docker images
REPOSITORY                        TAG                 IMAGE ID            CREATED                  VIRTUAL SIZE
..
eshepelyuk/hellodockergradle   latest              daa12bd8bb4f        About a minute ago   649 MB
..
```
3. Start container using docker run and inspect the output to match expected from Hello.groovy class.
```
$ docker run eshepelyuk/hellodockergradle
Hello from Docker by Groovy and Gradle
```
Full project’s code is available at My GitHub
Reference: JVM microservices – JVM based application as Docker container from our JCG partner Evgeny Shepelyuk at the jk’s blog blog.
Do you want to know how to develop your skillset to become a Java Rockstar?
Subscribe to our newsletter to start Rocking right now!
To get you started we give you our best selling eBooks for FREE!
1. JPA Mini Book
2. JVM Troubleshooting Guide
3. JUnit Tutorial for Unit Testing
4. Java Annotations Tutorial
5. Java Interview Questions
6. Spring Interview Questions
7. Android UI Design
and many more ....
I agree to the Terms and Privacy Policy
Sign up
Thank you!
We will contact you soon.
Tags
Docker JVM