Launching Docker Desktop with Spring Boot

I came across Docker Desktop for the first time about 3 years ago, when I was working as a Principal Architect (Strategic R & D) on the Microservices Reference Architecture for a product development organization. At the time, when I was working on my corporate laptop - It became a tedious task to configure virtualization and settings to get it to work. Once I got it running smoothly, I realized that the memory requirements required to run it were quite high. At times, I found it tough to use my laptop for daily development with it running. It was also because I was working on microservices and had almost 6+ spring boot applications running.

Again, In the last month I used Docker Desktop and found it be smoother and running without any issues. This was on my personal laptop. Also, It is attributed to the fact that I was running only one Microservice.

I will take you through step-by-step to install docker desktop and to create a docker image, push it to docker and then to create/start it in a docker container.

Requirements

1. Knowledge of Spring Boot

2. Basics of Docker Container

3. Windows 10 (Updated)

4. Docker for Windows Desktop

5. Eclipse (Spring Boot Project)

GitHub Link to Clone Repository / Fork Code

https://github.com/sumithpuri/skp-spring-boot-docker-desktop

⦿ Install Windows Subsystem for Linux

We will first begin by installing the Windows Subsytem for Linux (WSL2). You have to make sure that your Windows 10 has got all the latest updates. Else, you will not be able to locate the features explained.

Press ⊞+I to get to Windows Settings. Search/Click on [Apps & Features] > Click on [Optional Features] > Click on [More Windows Features] > Make Sure that the [Virtual Platform/Virtualization] is already selected. If you do not see any such option, you will have to make sure that you have enabled [Virtualization] in your BIOS.

Once you have made sure that [Virtual Platform/Virtualization] is already installed, Click on [Windows Subsystem for Linux] to install it on your system. You may optionally install the [Hyper-V/Windows Hypervisor Platform].

More details are available at the following link.

⦿ Install Docker for Windows Desktop

The next step is to download the Docker for Windows Desktop installable. You may download it from the official site, from this link. Please go through the installation process as it is pretty straightforward once you have all the pre-requisites. Also, make sure to create an account on [Docker Hub] using your e-mail. This can be used to push images to internet with public or private visibility.

⦿ Create a Spring Boot Application

The next step is to create a spring boot application. You may also update/edit your existing application to include the dockerfile and build via docker maven plugin. The example Spring Boot application can be cloned/forked from this link.

⦿ Include Maven Docker Plugin

<properties>  
  <java.version>1.8</java.version>  
  <docker.image.prefix>spring-boot-docker</docker.image.prefix>  
  <docker.image.exposed.port>8080</docker.image.exposed.port>  
  <docker.image.dockerfile.dir>${basedir}</docker.image.dockerfile.dir>  
  <docker.image.dockerize.version>v0.6.1</docker.image.dockerize.version>  
  <docker.plugin.version>1.2.0</docker.plugin.version>  
</properties> 

Make sure that your maven pom.xml that will be used to build the project has the following entries under <properties>.

The below is the snippet for the [dockerfile-maven-plugin] to be added to the <plugins> section of your maven pom.xml

<!-- dockerfile maven plugin -->  
<plugin>  
  <groupId>com.spotify</groupId>  
  <artifactId>dockerfile-maven-plugin</artifactId>  
  <version>1.4.12</version>  
  <configuration>  
    <repository>${docker.image.prefix}/${project.artifactId}</repository>  
    <buildArgs>  
      <JAR_FILE>target/${project.build.finalName}.jar</JAR_FILE>  
    </buildArgs>  
  </configuration>  
</plugin>  
<!-- dockerfile maven plugin -->  

⦿ Create a Dockerfile

The typical dockerfile for a spring boot application will look like the above. It contains the image of the jdk, the volume in the container for the data that is generated by container and the other line items for the binary/jar file and the command for  running this application in the container.

FROM openjdk:8-jdk-alpine   
VOLUME /tmp  
ARG JAR_FILE  
COPY ${JAR_FILE} spring-boot-docker.jar  
ENTRYPOINT ["java","-jar","/spring-boot-docker.jar"]

⦿ Create/Push Image to Docker

Use the following options while running maven. The plugin is the dockerfile and the goal is build. It will create and push an image to the docker for desktop that is running on port 2376.

mvn clean install dockerfile:build  

⦿ Create/Start the Docker Container

docker run -p 9090:8080 -t spring-boot-docker/skp-spring-boot-docker  

Next, Move to the folder where you have installed [docker]. It is a good practice to include that in the [PATH] environment variable, if you are going to frequently use docker. Then you can use the following command to create/start your docker container.

⦿ Test the Spring Boot Application

http://localhost:9090/springbootdocker/quote  

For this sample application, you will see that the spring boot applications gives the following output on the browser!

The next part of this article will focus on taking this to AWS Beanstalk/EC2, so that we can deploy this container on the AWS Cloud.

Watch out for the next article in this series titled “SKP’s SB #02 : Clean Shutdown of Spring Boot Applications”. “SKP’s SB Series” of Articles are entirely based on Spring Boot along with related topics like Docker Desktop, Java Timers, Spring Annotations and Clean Shutdown of Spring Boot Applications.