This web application provides the front door into the Inetgreatly initiative. It houses the various Tutorials (aka Steel Threads) as well as a dashboard of installed products/services.

yarn install
yarn start:dev

The webapp will automatically open (https://localhost:3006) in your browser and watch for file changes. When running locally, the available services list is mocked, and service urls set via env vars.

A git reference can be deployed to a remote OpenShift cluster.

cd deployment
./create_webapp.sh openshift.example.com:8443 webapp-001 development

NOTE: The cluster must be setup for cors manually. This requires adding the webapp route to the corsAllowedOrigins block in master-config.yml.

To rebuild & redeploy:

oc start-build -n webapp-001 tutorial-web-app

A git reference can be deployed to a remote OpenShift cluster.

cd deployment
./create_webapp.sh openshift.example.com:8443 webapp-001 development

NOTE: The cluster must be setup for cors manually. This requires adding the webapp route to the corsAllowedOrigins block in master-config.yml.

To rebuild & redeploy:

oc start-build -n webapp-001 tutorial-web-app

oc new-project tutorial-web-app
find . | grep openshiftio | grep application | xargs -n 1 oc apply -f
oc new-app --template react-demo-app -p SOURCE_REPOSITORY_URL=https://github.com/priley86/integr8ly-prototype -p SOURCE_REPOSITORY_REF=development

This project requires asciidoctor and yq for translating Ascii Docs to JSON.

Pre-requisites:

brew install asciidoctor
brew install python-yq

To convert ascii doc to HTML fragments, run the following:

cd ./public/asciidocs/en
asciidoctor [INPUT-ASCII-DOC-FILE] -s

To convert ascii doc files to JSON, you can run the following:

cd ./public/asciidocs/en
asciidoctor -b docbook [INPUT-ASCII-DOC-FILE] [OUTPUT-XML-FILE]
xq . [OUTPUT-XML-FILE] > [OUTPUT-JSON-FILE]

This JSON can then be referenced in the appropriate language locale under public/locales/*.json.

To do a release of the webapp, update the version in package.json

npm version x.y.z
git tag x.y.z

Push the changes (including the version tag) to the repo

git push origin master
git push --tags

This will trigger a new release build. If the build is successful, a new image will be pushed to https://quay.io/repository/integreatly/tutorial-web-app. The new image will be tagged as latest and the version number x.y.z.

TODO: Installing a released version of the webapp to OpenShift