Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ibm/application-modernization-javaee-quarkus

Application Modernization Sample - From Java EE (2010) to Cloud-Native (2021)
https://github.com/ibm/application-modernization-javaee-quarkus

cloudnative events-triggered jakartaee java javaee micro-frontends microprofile microservices openliberty opensource quarkus strangler websphere

Last synced: 30 days ago
JSON representation

Application Modernization Sample - From Java EE (2010) to Cloud-Native (2021)

Awesome Lists containing this project

README 

        
## Application Modernization - From Java EE in 2010 to Cloud-Native in 2021



This sample demonstrates how to modernize 10+ year-old Java EE applications with cloud-native technologies and the modern Java runtimes Quarkus and Open Liberty. The modernized application is deployed to and operated with OpenShift, the enterprise distribution of Kubernetes.



### Project Structure



* [Demonstrated Capabilities, Technologies and Tools](#demonstrated-capabilities-technologies-and-tools)

* [Introduction Video (12 mins)](#introduction-video)

* [Session Recording: Application Modernization and Rabbits (30 mins)](http://heidloff.net/article/webinar-recording-application-modernization-and-rabbits/)

* [Architecture](#architecture)

* [Documentation](#documentation)

* [Deployment via Docker Desktop](#deployment-via-docker-desktop)

* [Deployment to OpenShift on IBM Cloud with Tekton](#deployment-to-openshift-on-ibm-cloud-with-tekton)

* [Deployment to OpenShift on IBM Cloud with Tekton and ArgoCD](documentation/Deployments.md#deployment-to-openshift-on-ibm-cloud-with-tekton-and-argocd)

* [Deployment to OpenShift on IBM Cloud with local Scripts](documentation/Deployments.md#deployment-to-openshift-on-ibm-cloud-with-local-scripts)

* [More Deployment Options](documentation/Deployments.md)



### Demonstrated Capabilities, Technologies and Tools



Application modernization is a journey. The legacy application has been modernized in ten steps.



1. Monolith - WebSphere Traditional 8.5.5

    - Java EE 6 app from 2008 with Db2 database running in VMs or bare metal.

2. Monolith - WebSphere Traditional 9 in container

    - Application converted with Transformation Advisor.

3. Monolith - WebSphere Liberty

    - Application converted with Eclipse Migration Tools.

4. Separated frontend

    - Dojo frontend in separate container.

5. Monolith - Open Liberty

    - Modern project structure.

6. Strangled Catalog Service and remaining Open Liberty Monolith

    - Strangled catalog service (inspired by Mono2Micro) developed with Quarkus and Postgres.

    - Event driven architecture via Kafka.

7. Strangled Catalog Service and remaining Quarkus Monolith

    - Strangled Quarkus catalog service uses reactive programming model.

    - Remaining Quarkus monolith runs as native executable.

8. Micro frontend based web application

    - Developed with single-spa and Vue.js. Messaging is done via RxJS.

9. CI/CD via Tekton

    - Target OpenShift. Via OpenShift Pipelines operator.

10. CI/CD via Tekton and ArgoCD

    - Target OpenShift. Via OpenShift GitOps operator.



### Introduction Video



The following 12 minutes video describes the project on a high level:



[![Video](documentation/video.png)](https://youtu.be/lw95LLqa37g)



### Architecture



Architecture of the legacy application:






Screenshot of legacy storefront application:






Architecture of the modernized application:






Screenshot of modernized storefront application:






### Documentation



* Project Overview

    * [Project Overview Video](http://heidloff.net/article/video-application-modernization-in-baby-steps/) (12 mins)

    * Talk: [Application Modernization and Rabbits](http://heidloff.net/article/webinar-recording-application-modernization-and-rabbits/) (30 mins)

    * [Project Teaser Video](https://youtu.be/evhQ7BslMeU) (2 mins)

    * Rabbit video: [Application Modernization and Rabbits](http://heidloff.net/articles/application-modernization-and-rabbits/)

    * [Project Overview Slides](documentation/AppModernization.pdf)



* IBM Modernization Tools and IBM WebSphere

    * [Improving operational Efficiency through Application Modernization](http://heidloff.net/article/improving-operational-efficiency-through-application-modernization/)

    * [Modernizing Java EE Applications with WebSphere Liberty](http://heidloff.net/article/modernizing-java-ee-applications-with-websphere-liberty/)

    * [Step-by-Step Instructions how to use Transformation Advisor](http://heidloff.net/article/step-by-step-instructions-ibm-transformation-advisor/)

    * [Increasing Productivity for legacy Liberty Applications](http://heidloff.net/article/increasing-developer-productivity-for-legacy-liberty-applications/)

    * [Moving from WebSphere Liberty to Open Source with Open Liberty](http://heidloff.net/article/modernizing-websphere-liberty-applications-with-open-liberty/)



* Strangler Pattern and Event Driven Architecture

    * [Don’t build distributed Monoliths!](http://heidloff.net/article/do-not-build-distributed-monoliths/)

    * [Strangler Pattern Example](http://heidloff.net/article/strangler-pattern-example/)

    * [Step-by-Step Instructions for Mono2Micro](http://heidloff.net/article/step-by-step-instructions-mono2micro/)

    * [Event driven Architectures for loosely coupled Microservices](http://heidloff.net/article/event-driven-architectures-loosely-coupled-microservices/)

    * [Using Quarkus for building reactive Applications](http://heidloff.net/article/using-quarkus-reactive-applications)



* User Experience Modernization

    * [Modernizing Applications with new User Experiences](http://heidloff.net/article/modernizing-applications-with-new-user-experiences/)

    * [Using Micro Frontends in Microservices based Architectures](http://heidloff.net/article/using-micro-frontends-microservices/)

    * [Developing Micro Frontends with Single-Spa](http://heidloff.net/article/developing-micro-frontends-single-spa/)

    * [Developing loosely coupled Micro Frontends via RxJS](http://heidloff.net/article/developing-loosely-coupled-micro-frontends-rxjs/)



* OpenShift Development and Deployment Patterns

    * [Exernalizing Configurations for OpenShift Deployments](http://heidloff.net/article/externalizing-configurations-for-openshift-deployments/)

    * [Deploying Db2 on OpenShift](http://heidloff.net/article/deploying-ibms-db2-on-openshift/)

    * [Deploying Postgres on OpenShift](http://heidloff.net/article/deploying-postgres-on-openshift/)

    * [Deploying Kafka on OpenShift](http://heidloff.net/article/deploying-kafka-on-openshift/)

    * [Connecting to managed Database Services via TLS](http://heidloff.net/article/connecting-to-managed-database-services-via-tls/)

    * [Deployments of Applications to OpenShift via Source](http://heidloff.net/article/deployments-of-applications-to-openshift-via-source/)

    * [Deploying Nginx on OpenShift](http://heidloff.net/article/deploying-nginx-on-openshift/)

    * [Using CORS for OpenShift Applications](http://heidloff.net/article/using-cors-for-openshift-applications/)

    * [Running Liberty Applications with Db2 locally](http://heidloff.net/article/running-liberty-applications-with-db2-locally/)

    * [Running legacy Java Applications locally](http://heidloff.net/article/running-legacy-java-applications-locally/)



* CI/CD and DevOps

    * [Deploying Tekton on OpenShift](http://heidloff.net/article/deploying-tekton-on-openshift/)

    * [Sample Tekton Pipelines for Microservices](http://heidloff.net/article/sample-tekton-pipelines-for-microservices/)

    * [Debugging Tekton on OpenShift](http://heidloff.net/article/debugging-tekton-on-openshift/)

    * [Accessing GitHub in Tekton Tasks on OpenShift](http://heidloff.net/article/accessing-github-in-tekton-tasks-on-openshift/)

    * [Deploying ArgoCD on OpenShift](http://heidloff.net/article/deploying-argocd-on-openshift/)

    * [Using GitOps on OpenShift](http://heidloff.net/article/using-gitops-on-openshift/)



* Observability

    * [OpenShift Logging Quick Start](http://heidloff.net/article/openshift-logging-quick-start/)

    * [Logging for OpenShift via LogDNA](http://heidloff.net/article/logging-for-openshift-via-logdna/)



* More Resources

    * [10 Reasons why Enterprises should modernize Applications](http://heidloff.net/article/ten-reasons-why-enterprises-should-modernize-applications/)

    * [Application Modernization Resources on IBM Developer](http://heidloff.net/article/application-modernization-resources-on-ibm-developer/)

    * [IBM Garage Application Modernization Playbook](https://ibm-cloud-architecture.github.io/modernization-playbook/applications/refactor/)



### Deployment via Docker Desktop



If you want to run the modernized application locally, you can invoke the following commands. All you need is a local Docker installation and the git CLI.



Notes:

* Docker requires 14 GB memory, 10 CPUs and 80 GB disk space

* It takes roughly 15 - 20 minutes to start everything

* Make sure docker-compose is also installed (sounds like this needs to be installed separately on some systems)



```

$ git clone https://github.com/nheidloff/application-modernization-javaee-quarkus.git && cd application-modernization-javaee-quarkus

$ ROOT_FOLDER=$(pwd)

$ sh ${ROOT_FOLDER}/scripts-docker/build-and-run.sh

```



The 'build-and-run.sh' script will launch the following containers.






Once everything has been started, you can open the web applications:



* Legacy Dojo frontend: http://localhost/CustomerOrderServicesWeb

* Modern micro-frontend based application: http://localhost:8080



See the [documentation](documentation/RunDemo.md) how to run the demo.



### Deployment to OpenShift on IBM Cloud with Tekton



The following scripts deploy the modernized application on Red Hat [OpenShift on IBM Cloud](https://cloud.ibm.com/kubernetes/overview?platformType=openshift). However the same instructions should work for other OpenShift and OCP deployments, for example [CodeReady Containers](https://developers.redhat.com/products/codeready-containers/overview).



First create an [IBM Cloud Account](https://cloud.ibm.com/registration). Then create an OpenShift cluster, for example via the [IBM Cloud Dashboard](https://cloud.ibm.com/kubernetes/catalog/create?platformType=openshift). I've tested classic infrastructure, single zone, OpenShift 4.6.17, b3c.8x32 and 3 worker nodes.



Additionally you need to install Tekton. The easiest option is to use the '[OpenShift Pipelines](https://docs.openshift.com/container-platform/4.6/pipelines/installing-pipelines.html)' operator from the OperatorHub view in the OpenShift Console ([screenshots](documentation/deploy-tekton-1.png)). Simply accept all defaults. No local installations are necessary.



```

$ git clone https://github.com/nheidloff/application-modernization-javaee-quarkus.git && cd application-modernization-javaee-quarkus

$ ROOT_FOLDER=$(pwd)

$ sh ${ROOT_FOLDER}/scripts-openshift-tekton/check-prerequisites.sh

$ oc login ...

$ sh ${ROOT_FOLDER}/scripts-openshift/deploy-db2.sh

$ sh ${ROOT_FOLDER}/scripts-openshift/deploy-kafka.sh

$ sh ${ROOT_FOLDER}/scripts-openshift/deploy-postgres.sh

$ sh ${ROOT_FOLDER}/scripts-openshift-tekton/deploy-application.sh

$ sh ${ROOT_FOLDER}/scripts-openshift-tekton/show-urls.sh

```