Web App Starter Kit

The Common Services team is proud to become an active supporter of the QuickStart for OpenShift(QS). The Quickstart is a fully functional set of GitHub Actions workflows and a starter application stack intended to help Agile teams hit the ground running.

This page of our wiki will be evolving over the next few days as we document our own experiences with the QuickStart and a supplementary guide that may help other teams get started.

Table of Contents

• Useful Links
• CSS Demo Instance

Useful links

• Quickstart Openshift code repo
• OpenShift Registry
• MS Teams Support Channel (coming soon)

CSS Demo Instance

The Common Services team have deployed a sandbox app using the QS.

Notes taken throughout this learning process

1. Use the Quickstart Openshift repo as a template
2. In your GitHUb repo, add secrets and variables to GH Settings as described in the QS readme
3. If you require code-analysis, request SonarCloud projects from BCDevOps using this form
   • https://sonarcloud.io/project/configuration?id=bcgov-quickstart-one-backend
   • https://sonarcloud.io/project/configuration?id=bcgov-quickstart-one-frontend To allow integration, go to SonarCload project/account settings, generate a token and add it to the Tokens section in your GitHub repo setting
4. Configure rulesets
   • create a demo PR to see the different actions
   • create a ruleset main (see QS readme and config)
5. Setup environments test and prod
6. PR will only deploy if code has changed for front or backend. To test pipeline, alter code in one of those directories.
7. Sandbox deployment:
   • https://github.com/bcgov/qs1
   • https://console.apps.silver.devops.gov.bc.ca/k8s/ns/1dca6b-dev/apps~v1~Deployment
   • https://qs1-prod-frontend.apps.silver.devops.gov.bc.ca
   • https://qs1-prod-frontend.apps.silver.devops.gov.bc.ca/api (note: there is a React runtime error)
8. Deployment notifications sent to our MS Teams channel