Docker project

Java Application Dockerization Project

This project demonstrates how to dockerize a Java application by creating a Dockerfile, building a Docker image, and running it as a container in Windows PowerShell. This repository provides a complete guide and necessary files to containerize a simple Java application.

---

Features

• A step-by-step guide to containerizing a Java application.
• Usage of Docker to ensure consistent runtime environments.
• Build, run, and test the containerized application on any system with Docker installed.

---

Prerequisites

1. Docker Installed on Windows: Install Docker Desktop for Windows and ensure it is running. Download Docker Desktop

2. Java Development Kit (JDK):
   Ensure JDK is installed to compile the Java application.

3. Windows PowerShell:
   Open a terminal to execute Docker commands.

---

Project Structure

├── Dockerfile             # Instructions for building the Docker image
├── src/                   # Java source code directory
│   └── Main.java          # Simple Java application entry point
├── README.md              # Project documentation
└── target/                # Compiled Java application (created after build)
    └── app.jar            # Packaged JAR file of the application

---

Steps to Run the Project

1. Clone the Repository

Clone this GitHub repository to your local machine:

git clone https://github.com/your-username/java-docker-project.git
cd java-docker-project

---

2. Compile the Java Application

Navigate to the src/ folder and compile the Main.java file:

javac -d ../target src/Main.java

Then package the compiled code into a .jar file:

jar -cvf target/app.jar -C target .

---

3. Create the Dockerfile

Ensure the Dockerfile in the root directory contains the following:

# Use OpenJDK 17 base image
FROM openjdk:17-jdk-alpine

# Set the working directory in the container
WORKDIR /app

# Copy the JAR file into the container
COPY target/app.jar app.jar

# Run the application
CMD ["java", "-jar", "app.jar"]

---

4. Build the Docker Image

Use the following command in PowerShell to build the Docker image:

docker build -t java-app .

---

5. Run the Docker Container

Start a container using the built image:

docker run -it java-app

---

6. Verify the Application

After running the container, you should see the output of your Java application in the terminal.

---

Common Commands

List Docker Images

docker images

Stop Running Containers

docker ps           # List running containers
docker stop <CONTAINER_ID>

Remove Docker Containers

docker rm <CONTAINER_ID>

---

Future Enhancements

• Add support for environment variables.
• Automate builds with GitHub Actions.
• Include a multi-stage build for more efficient image sizes.

---

License

This project is licensed under the MIT License. See the LICENSE file for more details.

---

Feel free to contribute to this project by opening issues or submitting pull requests! 😊