oasp / s2i

Project for building and running Open Application Standard Platform (OASP) applications on OpenShift. This repository is totally based on the https://github.com/mickuehl/s2i-oasp repository, implemented by Michael Kuehl from RedHat.

Open Application Standard Platform Source-To-Image (S2I)

NOTE:

OASP has been superseded by devonfw, the Open Source Standard Software Development Platform for state of the art Cloud Native Micro Service and Multi Platform Rich Web Apps, supported by Capgemini.

See http://devonfw.com and on Github http://github.com/devonfw

Individual products within OASP have been renamed to a corresponding one in devonfw.

For example:

• OAPS4j -> devon4j
• OASP4js -> devon4ng
• OASP4NET -> devon4NET

devonfw® is an exclusive and registered (European Trademark) product of Capgemini. Capgemini reserves all intellectual and industrial property rights over devonfw but publishes it under the Apache License, Version 2 – like OASP- which makes devonfw 100% Open Source. See: https://tldrlegal.com/license/apache-license-2.0-(apache-2.0)

This project provides OpenShift builder images for each of the Open Application Standard Platform (OASP) components.

Overview

To build the OASP components, OpenShift's Source-to-Image (S2I) functionallity is used.

Currently there are builder images for

• OASP4J (Java)
• OASP4JS (JavaScript)

In order to get started, additional templates to deploy the OASP 'My Thai Star' reference application are provided.

Previous setup

In order to build all of this, it will be necessary, first, to have a running OpenShift cluster.

1. Download the executable oc.exe from here and paste it somewhere in your machine.

2. Once extracted and pasted, you can navigate to oc.exe's directory or add it to your PATH and execute oc cluster up.

Usage

Before using the builder images, add them to the OpenShift cluster.

Deploy the Source-2-Image builder images

First, create a dedicated devonfw project as admin.

$ oc new-project devonfw --display-name='DevonFW' --description='DevonFW Application Standar Platform'

Now add the builder image configuration and start their build.

$ oc create -f https://raw.githubusercontent.com/oasp/s2i/master/s2i/angular/s2i-devonfw-java-imagestream.json --namespace=devonfw
$ oc create -f https://raw.githubusercontent.com/oasp/s2i/master/s2i/angular/s2i-devonfw-angular-imagestream.json --namespace=devonfw
oc start-build s2i-devonfw-java --namespace=devonfw
oc start-build s2i-devonfw-angular --namespace=devonfw

Make sure other projects can access the builder images:

oc policy add-role-to-group system:image-puller system:authenticated --namespace=devonfw

That's all !

Deploy DevonFW templates

Now, it's time to create devonfw templates to use this s2i and add it to the browse catalog. More information:

• DevonFW templates.

Build All

Use script build.sh to automatically install and build all image streams. The script also creates templates devonfw-angular and devonfw-java inside the project 'openshift' to be used by everyone.

1. Open a bash shell as Administrator
2. Execute shell file:

$ /PATH/TO/BUILD/FILE/build.sh

Further documentation

• The 'My Thai Star' reference application templates
• Source-2-Image
• Open Application Standard Platform

Links & References

This is a list of useful articels etc I found while creating the templates.

• Template Icons
• Red Hat Cool Store Microservice Demo
• Openshift Web Console Customization