manishmbm2010 / event-driven-knapsack-microservices Goto Github PK

1. Spring Boot for writing Microservice
2. Kafka for Event Store
3. STS(Spring tool suite) for code development
4. Maven for dependency management
5. Docker for containerizing the solution

You can do below things via rest services

1. Submit knapsack probelm.
2. Retrive the task status and their solutions.
3. Get the complete list of tasks and the stage in which they are currently running.(stages = submitted ,started,completed).

Overall Solution contains 3 microservices(Input,Solution,Admin), running in separate docker containers and Kafka container as a event store to make async communocation between different services.

1. User facing Input Microservice to get the knapsack problem in and provide the status and solution of individual problem.
2. Solution Microservice reads the new problem from kafka , process the solution and post the solution back to kafka.
3. Admin Microservice reads for first two micorservices for any new knapsack problem or update of on existing problem and update its state accordingly to provide the overall view of all the problems.

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deploymentnotes to deploy the project on a live system.

Docker machine should be up and running and docker-compose should be installed

1. git clone https://github.com/Manishmbm2010/Event-Driven-Knapsack-Microservices.git
2. cd Event-Driven-Knapsack-Microservices
3. cd KnapSackInput/
4. docker run -it --rm -v "$PWD":/usr/src/app/ --volume "$HOME"/.m2:/root/.m2 -w /usr/src/app/ maven:3-jdk-8-alpine mvn clean install
5. cd ../KnapSackSolution/
6. docker run -it --rm -v "$PWD":/usr/src/app/ --volume "$HOME"/.m2:/root/.m2 -w /usr/src/app/ maven:3-jdk-8-alpine mvn clean install
7. cd ../KnapSackAdmin/
8. docker run -it --rm -v "$PWD":/usr/src/app/ --volume "$HOME"/.m2:/root/.m2 -w /usr/src/app/ maven:3-jdk-8-alpine mvn clean install
9. docker-compose up --build

Input/Output Json format has been attached in separate file withe examples , Please have a look end_point_input_output_format.txt

• http://localhost:8090/knapsack/tasks (method=POST)
• http://localhost:8090/knapsack/tasks/{id} (method=GET)
• http://localhost:8090/knapsack/solutions/{id} (method=GET)
• http://localhost:8080/knapsack/admin/tasks/ (method=GET)

Yet to Be configured:

• http://localhost:8080//knapsack/admin/logs (method=GET)
• http://localhost:8080//knapsack/admin/health (method=GET)
• http://localhost:8080//knapsack/admin/shutdown (method=POST)
• http://localhost:8080/v2/api-docs (method=GET)
• http://localhost:8080/swagger-ui.html

Automated test case suit has not been added with the project.

Time Complexity: O(nW) where n is the number of items and W is the capacity of knapsack.

• Maven - Dependency Management

Find we few best resources for finalizing the design and completeing the project

• Architecture design decison based on below resource ** 1. https://www.youtube.com/watch?v=IR1NLfaq7PU&t=2492s&list=PLcgk_TLI6Dot90MJl7Qo2wIL-3EqcjOeb&index=3
• https://www.toptal.com/java/spring-boot-rest-api-error-handling
• https://spring.io/guides/gs/spring-boot-docker/
• https://docs.docker.com/
• Java Brains : Spring Boot tutorail Series
• Sample youtube link : https://www.youtube.com/watch?v=msXL2oDexqw&list=PLqq-6Pq4lTTbx8p2oCgcAQGQyqN8XeA1x

• Currently solution has been designed with embedded derby database , can be configured with separate database docker image with persistent mount.
• kafka container can be mounted on persistent storage.
• Spring security can be implemented.
• Deployment instruction can be prepared to deploy on Kubernetes cluster.
• Exception handling has to be added.
• Logging can be enhanced.
• Comments can be improved and extended further to make the maintenace of code much simpler later on.

Manish Jain