mavogel / vis-lab

Splitting a monolithic web shop application from Tomcat into microservices with Spring Boot and Docker. This project is part of the masters course 'Distributed Information Systems' at the University of Applied Sciences (Karlsruhe)

Distributed Information Systems Laboratory aka vis-lab

Splitting a monolithic web shop application, running on a Tomcat into small domain-driven microservices with Spring Boot and Docker. This project is part of the masters course 'Distributed Information Systems' at the University of Applied Sciences (Karlsruhe).

Prerequisites

• maven
• docker
• docker-compose

Starting

Legacy System

• Start Docker daemon
• Check out the project, export variables and simply run the script:

$ chmod +x run_legacy.sh
$ ./run_legacy.sh

• Builds the web app war, packs it into a docker tomcat8 container, and sets the user tomcat with password admin for the Management Console at http://localhost:8888/
• Inits the MySQL Database docker container with the db user defined in hibernate.cfg.xml
• Sets up both containers and make the legacy webshop available under http://localhost:8888/EShop-1.0.0/

Microservice Architecture

• Start Docker daemon
• Check out the project and simply run the script:

# Build all microservices, create docker images and start them
$ ./run_microservices.sh

• Access the new webshop 2.0 via http://localhost:8899/EShop-Micro-2.0.0/

# for shutting down
$ ./shutdown_microservices.sh

Useful links

• Eureka service registry: http://localhost:8761/
• Zuul Gateway routes: http://localhost:8765/routes

Note: run e.g. curl -D- -X GET localhost:8765/category first, so hystrix produces stream data

• Local Monitoring Dashboard for Composite: http://localhost:8084/hystrix -> enter url http://localhost:8765/hystrix.stream
• Monitoring Dashboard Service: http://localhost:7979/hystrix
  • cat comp: http://categorycompositeservice:8080/hystrix.stream
  • gateway: http://api-gateway:8765/hystrix.stream

curl statements for testing:

1. Obtain the access token and refresh token for the grand_type=password via one of the three methods:

• curl -v -H "Authorization: Basic $(echo -n 'acme:acmesecret' | base64)" http://localhost:8765/uaa/oauth/token -d grant_type=password -d username=admin -d password=admin
• curl -v -u acme:acmesecret http://localhost:8765/uaa/oauth/token -d grant_type=password -d username=admin -d password=admin
• curl -v http://acme:acmesecret@localhost:8765/uaa/oauth/token -d grant_type=password -d username=admin -d password=admin

2. Save the obtained access token in the ACCESS_TOKEN env var: export ACCESS_TOKEN=eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE0ODQ0ODExM...

3. Perform requests

• curl -v 'http://localhost:8765/category' -i -X GET -H 'Content-type: application/json' -H "Authorization: Bearer $ACCESS_TOKEN"
• curl -v 'http://localhost:8765/category' -i -X POST -H 'Content-Type: application/json' -H "Authorization: Bearer $ACCESS_TOKEN" -d '{"name":"TestCategory"}'
• curl -v 'http://localhost:8765/product' -i -X GET -H 'Content-type: application/json' -H "Authorization: Bearer $ACCESS_TOKEN"
• curl -v 'http://localhost:8765/product' -i -X POST -H 'Content-Type: application/json' -H "Authorization: Bearer $ACCESS_TOKEN" -d '{"name":"NewProduct", "price":"1.00", "category":"1", "details":"fancy details"}'
• curl -v 'http://localhost:8765/user/admin' -i -X GET -H "Authorization: Bearer $ACCESS_TOKEN"
• curl -v 'http://localhost:8765/user/register' -i -X POST -H 'Content-Type: application/json' -d '{"username":"jdoe", "firstname":"John", "lastname":"Doe", "password":"s3cr3t"}'

Debugging:

Check MySQL contents

• Connect to container: docker exec -it <#containerId> bash
• Connect to db: mysql -h localhost -D webshop -u webshopuser -p240b2c6d58ff2ce2f508b49f

API Documentation

The documentation of the services

• CategoryService
• ProductService
• UserService is available at the api-gateway: http://localhost:8765/docs/api-guide.html

Notes

If you change the user and password of the MySQL database, you should run

$ docker-compose -f docker-compose-legacy.yml rm -v
$ rm -rf .data

Details can be found here