Skip to content

Latest commit

 

History

History
47 lines (33 loc) · 4.28 KB

README.md

File metadata and controls

47 lines (33 loc) · 4.28 KB
Raw

Demonstration : Micro-service Apps w/ IBM i & OpenShift

Link to the full presentation "OpenShift & IBM i introduction" demonstrating how to combine the state of the art db server IBM i/Db2 for i with a cloud native microservice architecture on Redhat OpenShift.

Based on real customer requests, it is a good conversation starter illustrating the use of the latest technologies on a live environment (#ShowNotTell) and a fictive company ‘AcmeAir’: app development and test of a microservice application running on OpenShift integrated with a 'customer' (CRM) microservice running on IBM i / Db2 Mirror for i. Stateless and Stateful: Best of both worlds.

Find videos & demos on this topic or others on my humble Youtube Channel and on the IBM Customer Experience Portal (IBMID required)

Acme Air Customer Service - Java/Liberty + JDBC (Db2 for i) version

Implementation of the Acme Air Customer Service for Java/Liberty. The primary task of the customer service is to store, update, and retrieve customer data on Db2 for i. It can be adapted for any jdbc based database server. Fork from the Mongodb based Customer Service.

IBM i (Db2 for i) is a rock solid database server with HA and DR capabilities. This example shows you how to integrate the Kubernetes and Stateless world with the Stateful and Transactional world on IBM i. With Db2 for i: potentially ZERO interruption, ZERO downtime, and 24x7 access to your database and business critical applications.

OCP IBM i

Build Instruction for OpenShift / MiniShift or CodeReady Containers

  • First, git clone this repository, in addition to the other microservices from the BluePerf project. use the test branch : branch microprofile-3.3 , use the git option --branch microprofile-3.3 (do that for each microservice in the BluePerf project)
  • Download and Copy an up to date jdbc driver in the 'drivers' folder. ex: jt400.jar
  • Use the scripts in the 'drivers' folder to create the acmeair database and import the initial data.
  • Install maven, oc cli , docker or podman client first. Refer to the original BluePerf project instructions.
  • Follow the instruction on BluePerf (link above) to build & deploy the other microservices.
  • Build and deploy this micro-service (replacing the initial Customer Service by this Db2 for i alternative from in a single command using the following commands. Note: Feel free to change that, but the default user profile used here is 'acmeair' , password is 'password', library (sql collection) is acmeair. Update the Deployment environment variable values according to your environement (user, password, lib list)

Example 1 - Single Db2 for i server:

  • $ export DB2FORI_HOSTNAME=bendemo.10.7.19.71.nip.io
  • $ cd scripts
  • $ ./buildAndDeployToOpenshift-CustomerService.sh default-route-openshift-image-registry.apps-crc.testing/acmeair image-registry.openshift-image-registry.svc:5000/acmeair acmeair-acmeair.apps-crc.testing docker open-liberty:full

Example 2: K8s + Db2 Mirror and Alternate database server (jdbc, Db2 Mirror for i)

Refer to this jdbc/jtopen documentation. This scenario with automatic failover from a micro-service requires the LATEST version of jtopen, to be placed in the drivers folder. OCP IBM i Db2 Mirror for i

  • $ export DB2FORI_HOSTNAME=bendemo.10.7.19.71.nip.io
  • $ export DB2FORI_HOSTNAME_ALT=db2acmeair2.10.3.60.81.nip.io
  • $ cd scripts
  • $ ./buildAndDeployToOpenshift-CustomerService.sh default-route-openshift-image-registry.apps.sandbox.power.mpl/bmarolleau default-route-openshift-image-registry.apps.sandbox.power.mpl/bmarolleau acmeair-bmarolleau.apps.sandbox.power.mpl podman

Architecture Overview :

OCP IBM i ArchOverview

Jenkins and Apache JMeter :

Instructions for Jenkins automation and JMeter scripts in the perftest folder.