Update: June 2018 moved to Gitlab.

App Dev Cloud with JBoss Cool Store Persistence Demo

This demo is to install JBoss Cool Store in the Cloud with PostgreSQL data persistence on any OpenShift Container Platform. It delivers a fully functioning JBoss Cool Store containerized on OSE and backed by a persistent data store.

The Cool Store is a retail web store demo where you will find rules, decision tables, events, and a ruleflow that is leveraged by a web application. The web application is a WAR built using the JBoss BRMS generated project as a dependency, providing an example project showing how developers can focus on the application code while the business analysts can focus on rules, events, and ruleflows in the JBoss BRMS product web based dashboard.

Alongside the Cool Store is a PostgreSQL database container that provides persistent storage for the JBoss BRMS platform and connected via Kubernetes services.

This demo environment is fully containerized, it uses a custom maven settings to deploy all built JBoss BRMS knowledge artifacts into an external maven repository (not your local repository), in /tmp/maven-repo.

Install on OpenShift

1. (OPTIONAL) First ensure you have an OpenShift container based installation, such as one of the followling installed first:

• OCP Install Demo

• Red Hat Container Development Kit (CDK) using Minishift

• or your own OpenShift installation.

2. Download and unzip this demo.

3. Download JBoss EAP & JBoss BRMS, add to installs directory (see installs/README).

4. Run 'init.sh' or 'init.bat' file. 'init.bat' must be run with Administrative privileges:

   # The installation needs to be pointed to a running version
   # of OpenShift, so pass an IP address such as:
   #
   $ ./init.sh 192.168.99.100  # example for OCP.

Login to Cool Store to start exploring a retail web shopping project (the address will be generated by the init script):

• OCP example: http://rhcs-coolstore-p-demo-appdev-in-cloud.192.168.99.100.nip.io/business-central ( u:erics / p:jbossbrms1! )

• OCP example web app: http://rhcs-coolstore-p-demo-appdev-in-cloud.192.168.99.100.nip.io/brms-coolstore-demo

5. Want to build the Cool Store demo from scratch? Try these hands-on online workshops.

Notes:

Should your local network DNS not handle the resolution of the above address, giving you page not found errors, you can apply the following to your local hosts file:

$ sudo vi /etc/hosts

# add host for OCP demo resulution
192.168.99.100   rhcs-coolstore-p-demo-appdev-in-cloud.192.168.99.100.nip.io 

---

If for any reason the installation breaks or you want a new JBoss BRMS installation, just remove the project rhcs-brms-install-demo entry in the OpenShift console and re-run the installation.

---

To clone a repository in the running container, the following actions would need to occur from a developer's machine.

1. Execute port forwarding through the OpenShift CLI. This will open a tunnel between the developer's machine and the pod through the OpenShift API pod proxy. The command window will block while the session is open:

   # Read-only access to repo on port 9418.
   #
   $ oc port-forward $(oc get pod -l=deploymentconfig=rhcs-coolstore-p-demo --template='{{ range .items }} {{ .metadata.name }} {{ end }}') 9418:9418
   
   # Read-write access to repo on port 8001.
   #
   $ oc port-forward $(oc get pod -l=deploymentconfig=rhcs-coolstore-p-demo --template='{{ range .items }} {{ .metadata.name }} {{ end }}') 8001:8001
   

2. Clone the repository. In another window, clone the remote repository:

   # Read-only access to repo on port 9418.
   #
   $ git clone git://localhost:9418/coolstore-demo
   
   # Read-write access to repo on port 8001.
   #
   $ git clone git://localhost:8001/coolstore-demo
   

Supporting Articles

• 10 Steps to Cloud Happiness: Step 7 - Retail Web Shop

• Retail in the Cloud - Business rule integration in retail with Vaadin 8.1

• How to add Cloud persistent storage to JBoss Cool Store

• Ultimate Cloud Guide to Retail in the Cloud with JBoss Cool Store

Released versions

• v1.7 - JBoss BRMS 6.4.0 and JBoss EAP 7.0.0 with Cool Store leveraging postgresql persistence and available on CDK with Minishift.

• v1.6 - JBoss BRMS 6.4.0 and JBoss EAP 7.0.0 with Cool Store leveraging postgresql persistence with OpenShift genereated routes and service URLs.

• v1.5 - JBoss BRMS 6.4.0 and JBoss EAP 7.0.0 with Cool Store leveraging postgresql persistence installed on any given OpenShift installation and loading mulitple projects.

• v1.4 - JBoss BRMS 6.4.0 and JBoss EAP 7.0.0 with Cool Store leveraging postgresql persistence installed on any given OpenShift installation and port forwarding for git repo access configured.

• v1.3 - JBoss BRMS 6.4.0 and JBoss EAP 7.0.0 with Cool Store leveraging postgresql persistence installed on any given OpenShift installation.

• v1.2 - JBoss BRMS 6.3.0 and JBoss EAP 6.4.7 with Cool Store leveraging postgresql persistence installed on Red Hat CDK.

• v1.1 - JBoss BRMS 6.2.0.GA-redhat-1-bz-1334704 and JBoss EAP 6.4.4 with Cool Store leveraging postgresql persistence installed on Red Hat CDK.

• v1.0 - JBoss BRMS 6.2.0-BZ-1299002, JBoss EAP 6.4.4 with Cool Store leveraging postgresql persistence installed on Red Hat CDK using OpenShift Enterprise image.