Dockerfile for Spring Boot in Spring Boot - Mini Project: Build & Apply

Dockerfile for Spring Boot

📖 Scenario: You have created a simple Spring Boot application and want to package it into a Docker container. This will help you run your app anywhere without worrying about the environment setup.

🎯 Goal: Build a Dockerfile that creates a Docker image for your Spring Boot application. The Dockerfile will start from a base Java image, copy your app's jar file, and set the command to run it.

📋 What You'll Learn

Create a Dockerfile starting from the OpenJDK 17 base image

Copy the Spring Boot jar file named app.jar into the image

Set the command to run the jar file using java -jar app.jar

Expose port 8080 for the application

💡 Why This Matters

🌍 Real World

Dockerizing Spring Boot apps is common to deploy them easily on cloud servers or local machines without setup issues.

💼 Career

Knowing how to write Dockerfiles for Java apps is a key skill for DevOps engineers and backend developers working with containerized deployments.

1

Create the base image

Write a line in the Dockerfile to use the OpenJDK 17 image with slim version as the base image. Use FROM openjdk:17-slim.

Spring Boot

# Your code here

Hint

The FROM instruction sets the base image for your Docker image.

2

Copy the Spring Boot jar file

Add a line to copy the file named app.jar from your project folder into the Docker image's root directory. Use COPY app.jar /app.jar.

Spring Boot

FROM openjdk:17-slim
# Your code here

Hint

The COPY instruction copies files from your computer into the Docker image.

3

Expose port 8080

Add a line to expose port 8080 in the Dockerfile using EXPOSE 8080. This tells Docker the app listens on this port.

Spring Boot

FROM openjdk:17-slim
COPY app.jar /app.jar
# Your code here

Hint

The EXPOSE instruction documents the port your app uses.

4

Set the command to run the app

Add a line to run the Spring Boot jar file using CMD ["java", "-jar", "/app.jar"]. This tells Docker how to start your app.

Spring Boot

FROM openjdk:17-slim
COPY app.jar /app.jar
EXPOSE 8080
# Your code here

Hint

The CMD instruction sets the default command to run when the container starts.

Practice

1. What is the main purpose of a Dockerfile in a Spring Boot project?

easy

A. To write the Java code for the Spring Boot application

B. To define how to package and run the Spring Boot app inside a container

C. To configure the database connection settings

D. To create unit tests for the Spring Boot app

Solution

1. Step 1: Understand the role of Dockerfile

   A Dockerfile contains instructions to build a Docker image that packages the app and its environment.

2. Step 2: Identify its use in Spring Boot

   For Spring Boot, it defines how to copy the app jar, expose ports, and run the app in a container.

3. Final Answer:

   To define how to package and run the Spring Boot app inside a container -> Option B

4. Quick Check:

   Dockerfile = Package & run app [OK]

Hint: Dockerfile builds container image for your app [OK]

Common Mistakes:

• Confusing Dockerfile with source code files
• Thinking Dockerfile configures app logic
• Assuming Dockerfile is for testing only

2. Which of the following is the correct syntax to copy the Spring Boot jar file into the Docker image in a Dockerfile?

easy

A. COPY /app.jar target/app.jar

B. MOVE target/app.jar /app.jar

C. ADD target/app.jar

D. COPY target/app.jar /app.jar

Solution

1. Step 1: Understand COPY command syntax

   The COPY command syntax is: COPY source_path destination_path inside the image.

2. Step 2: Apply to Spring Boot jar

   We copy the built jar from local 'target/app.jar' to '/app.jar' inside the image.

3. Final Answer:

   COPY target/app.jar /app.jar -> Option D

4. Quick Check:

   COPY source destination [OK]

Hint: COPY source then destination path [OK]

Common Mistakes:

• Using MOVE instead of COPY
• Missing destination path in ADD
• Reversing source and destination paths

3. Given this Dockerfile snippet:

FROM openjdk:17-jdk-slim
COPY target/app.jar /app.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "/app.jar"]

What happens when you run the built Docker image?

medium

A. The container runs but does not start the app

B. The container fails because EXPOSE is missing

C. The container runs the Spring Boot app on port 8080

D. The container runs the app but on port 80

Solution

1. Step 1: Analyze Dockerfile commands

   FROM sets base image with Java 17. COPY adds app.jar. EXPOSE 8080 declares port. ENTRYPOINT runs the jar.

2. Step 2: Understand container behavior

   When run, container starts Java app listening on port 8080 as declared.

3. Final Answer:

   The container runs the Spring Boot app on port 8080 -> Option C

4. Quick Check:

   ENTRYPOINT runs app, EXPOSE 8080 [OK]

Hint: ENTRYPOINT runs app; EXPOSE shows port [OK]

Common Mistakes:

• Thinking EXPOSE runs the app
• Assuming default port 80 without config
• Ignoring ENTRYPOINT command

4. You wrote this Dockerfile:

FROM openjdk:17-jdk-slim
COPY app.jar /app.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "/app.jar"]

But when running the container, it fails with 'file not found'. What is the likely cause?

medium

A. The jar file is not named 'app.jar' in the build folder

B. EXPOSE 8080 is missing

C. ENTRYPOINT syntax is incorrect

D. Base image openjdk:17-jdk-slim does not support Java

Solution

1. Step 1: Check COPY source path

   COPY expects a local file named 'app.jar' but likely the jar is named differently or in a different folder.

2. Step 2: Understand error cause

   If the jar is missing or misnamed, container cannot find '/app.jar' to run, causing failure.

3. Final Answer:

   The jar file is not named 'app.jar' in the build folder -> Option A

4. Quick Check:

   COPY source must match actual jar name [OK]

Hint: Check jar filename matches COPY source [OK]

Common Mistakes:

• Assuming EXPOSE affects file copying
• Miswriting ENTRYPOINT array syntax
• Blaming base image for missing file

5. You want to optimize your Spring Boot Dockerfile to use a smaller image and faster startup. Which Dockerfile snippet achieves this best?

hard

A. FROM openjdk:17-jre-slim
COPY target/app.jar /app.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "/app.jar"]

B. FROM alpine
COPY target/app.jar /app.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "/app.jar"]

C. FROM openjdk:17-jdk-slim
COPY target/app.jar /app.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "/app.jar"]

D. FROM openjdk:17-jdk
COPY target/app.jar /app.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "/app.jar"]

Solution

1. Step 1: Compare base images

   openjdk:17-jre-slim has only Java runtime, smaller than jdk images which include compilers.

2. Step 2: Evaluate options for size and startup

   Using jre-slim reduces image size and speeds startup. Alpine lacks Java by default, causing errors.

3. Final Answer:

   FROM openjdk:17-jre-slim COPY target/app.jar /app.jar EXPOSE 8080 ENTRYPOINT ["java", "-jar", "/app.jar"] -> Option A

4. Quick Check:

   Use JRE slim for smaller, faster images [OK]

Hint: Use JRE slim base image for smaller Docker images [OK]

Common Mistakes:

• Using full JDK image unnecessarily
• Choosing Alpine without Java setup
• Ignoring image size impact