Crafting Docker Containers for Your Spring Boot Applications

Abassi Sabri — Wed, 27 Mar 2024 00:43:51 +0000

Introduction

Docker containers offer a lightweight and portable way to package and deploy your Spring Boot applications. This article guides you through the essential steps of creating a Docker container for your Spring Boot project, enabling you to streamline your development and deployment workflows.

Prerequisites

Docker installed and running on your system. Here !.
A Spring Boot project with a generated executable JAR file (typically located in target/ directory).
Basic understanding of Docker concepts.

Create a Dockerfile:

In the root directory of your Spring Boot project, create a plain text file named Dockerfile. This file specifies the instructions for building your Docker image.

Define the Base Image:

The first line in your Dockerfile specifies the base image upon which your Spring Boot application will run. A common choice is openjdk:21-slim (or a similar JDK version) as it provides a lightweight Java runtime environment.

# Dockerfile
FROM openjdk:21-slim

Copy the JAR File:

Use the COPY instruction to copy your Spring Boot application's JAR file from your project directory to a suitable location within the container image.

# Dockerfile
FROM openjdk:21-slim

ARG JAR_FILE=target/*.jar

COPY ${JAR_FILE} app.jar

Define the Entrypoint:

The ENTRYPOINT instruction specifies the command to be executed when the container starts. If your Spring Boot application has a main method, you can use the following:

# Dockerfile
FROM openjdk:21-slim

ARG JAR_FILE=target/*.jar

COPY ${JAR_FILE} app.jar

ENTRYPOINT ["java", "-jar", "app.jar"]

Build Docker Image :

docker build -t <image-name> .

Check The list of images :

docker images

Run the Container:

Use the docker run command to start a container from your newly built image. Here's the basic syntax:

docker run -d -p <host-port>:<container-port> <image-name>

host-port: The port on your host machine that will be mapped to the container's application port (usually the default Spring Boot port, 8080).
container-port : The port within the container that your application listens on (defaults to 8080 for Spring Boot).
image-name: The name of your Docker image created.

Example:

 docker run -d -p 8081:8081 --name test-microservice test-image

 docker ps # list of running containers

Thx For Reading!

How to Manage Git Branches for Jira Tickets in IntelliJ IDEA

Abassi Sabri — Tue, 26 Mar 2024 23:05:40 +0000

Introduction

This tutorial guides you through effectively managing Git branches for your Jira tickets using IntelliJ IDEA. This approach streamlines collaboration, tracks changes, and ensures a clean development workflow.

Prerequisites

Basic understanding of Git commands
Project connected to a Git repository (e.g., GitHub, GitLab)
Active Jira account with a project integrated with your Git repository (optional but highly recommended)

Creating a Branch per Jira Ticket

Open the Version Control (VCS) Menu: In IntelliJ IDEA, navigate to Git >.
Create a New Branch: Select New Branch.
Name Your Branch: Use a descriptive naming convention reflecting the Jira ticket.
A common pattern is feature/-, for example, feature/ABC-123-add-user-login. This practice improves clarity and traceability.
Checkout the New Branch: Select Checkout to start working on your changes in the new branch. This isolates your development from the main codebase.

Equivalent Git Commands :

git checkout -b feature/ABC-123-add-user-login  # Creates and switches to the new branch

Making Changes and Committing

Code Edits: Make your code modifications related to the Jira ticket in the designated branch.
Commit Your Changes: When ready, go to Git > Commit or use the commit icon in the toolbar.
Write a Clear Commit Message: Describe your changes concisely, often referencing the Jira ticket ID for easier tracking. A good format follows the conventional style: (): . Example: fix(ABC-123): Implemented user login functionality.
Pushing Changes to Remote Repository : Push to Remote Repository: If you're collaborating with others and want to share your local branch, go to Git > Push. Select the remote repository and the branch you want to push to (usually origin and your branch name).

Equivalent Git Commands :

git add modified-file-1 modified-file-2 
git commit -m "Message"
git push origin feature/ABC-123-add-user-login

Merging into main after validation

Once you've completed work on your feature branch, received validation/testing approval, it's time to integrate your changes into the main branch. Here's how to achieve this :

Let's startby downloading the latest changes from the remote repository, then switching to the main branch for local work :

git fetch && git checkout main

Now Merge the feature branch into you main branch ! (If there is a conflict resolve it then remerge).

Thanks for reading!

DEV Community: Abassi Sabri

Crafting Docker Containers for Your Spring Boot Applications

Introduction

Prerequisites

Create a Dockerfile:

Define the Base Image:

Copy the JAR File:

Define the Entrypoint:

Build Docker Image :

Check The list of images :

Run the Container:

Example:

How to Manage Git Branches for Jira Tickets in IntelliJ IDEA

Introduction

Prerequisites

Creating a Branch per Jira Ticket

Making Changes and Committing

Merging into main after validation