This is an example demo showing a retail store consisting of several of microservices based on JBoss EAP 7 and Node.js, deployed to OpenShift.
It demonstrates how to wire up small microservices into a larger application using microservice architectural principals.
There are several individual microservices and infrastructure components that make up this app:
- Catalog Service - Java application running on JBoss Web Server (Tomcat) and MongoDB, serves products and prices for retail products
- Cart Service - Java EE application running on JBoss EAP 7, manages shopping cart for each customer
- Inventory Service - Java EE application running on JBoss EAP 7 and PostgreSQL, serves inventory and availability data for retail products
- Coolstore Gateway - Java EE + Spring Boot + Camel application running on JBoss EAP 7, serving as an entry point/router/aggregator to the backend services
- Web UI - A frontend based on AngularJS and PatternFly running in a Node.js container.
This demo makes use of OpenShift Source-to-Image process for JBoss EAP, JBoss Web Server and NodeJS. Therefore you need to have an Image Stream defined for each respective builder image. If they are not already available on your OpenShift environment, run the following to create them:
oc login -u system:admin
oc delete -n openshift -f 'https://raw.githubusercontent.com/jboss-openshift/application-templates/master/jboss-image-streams.json'
oc delete -n openshift -f 'https://raw.githubusercontent.com/openshift/openshift-ansible/master/roles/openshift_examples/files/examples/v1.3/image-streams/image-streams-rhel7.json'
oc create -n openshift -f 'https://raw.githubusercontent.com/jboss-openshift/application-templates/master/jboss-image-streams.json'
oc create -n openshift -f 'https://raw.githubusercontent.com/openshift/openshift-ansible/master/roles/openshift_examples/files/examples/v1.3/image-streams/image-streams-rhel7.json'
Deploy the openshift-templates/coolstore-template.yaml
in order to deploy this demo:
oc login -u developer
oc new-project coolstore
oc process -f coolstore-template.yaml | oc create -f -
When all pods are deployed, verify all services are functioning:
oc rsh $(oc get pods -o name -l application=coolstore-gw)
curl http://catalog-service:8080/api/products
curl http://inventory-service:8080/api/availability/329299
curl http://cart-service:8080/api/cart/FOO
Access the web interface by pointing your browser at the web-ui
route url.
Notice the UI pods only expose an HTTP endpoint - when users access the UI service through HTTPS, OpenShift handles the TLS termination at the routing layer.
- If you attempt to deploy any of the services, and nothing happens, it may just be taking a while to download the Docker builder images. Visit the OpenShift web console and navigate to Browse->Events and look for errors, and re-run the 'oc delete ; oc create' commands to re-install the images (as outlined at the beginning.)