Spring Rest - A RESTful API written in Spring Boot

Install the pipeline and projects setup

If you do not have helm3 installed, execute the script:

./install-helm.sh

Execute the setup script:

./setup.sh

The pipeline installation will also start the first pipeline execution.

Webhooks

If you want to test the pipeline triggering via webhooks you should register a webhook in your forked repo. The Webhook should point to your listener's route.

In order to get the route execute this command in the namespace basic-spring-boot-cicd (You should be there by default):

oc get route webhook-listener -ojsonpath='{.spec.host}'

Application

The code is simple app using Spring Boot as part of Red Hat OpenShift Application Runtimes.

Usage to Run Locally

1. git clone
2. mvn spring-boot:run

Test Endpoints

1. curl -v http://localhost:8080/v1/greeting

2. curl -v http://localhost:8080/v1/hostinfo

3. curl -v http://localhost:8080/v1/envinfo

Added Plugins for Quality and Security

1. SonarQube Scanner Plugin. NOTE: This plugin is a client and needs to connect to a running sonar server.

   • Usage:
     • mvn sonar:sonar to execute.
     • Plugin is currently not tied to the standard maven lifecyle.
   • To help execute the scan in Jenkins pipelines, the sonarqubeStaticAnalysis() function from the pipeline-library will execute the goal in your build process.
   • SonarQube plugin docs

2. Jacoco Maven Plugin

   • Usage:
     • mvn package to execute in standard maven lifecycle
     • mvn jacoco:report to execute the plugin standalone
   • Code coverage reports will then be found in target/site.
   • Jacoco plugin docs

3. OWASP Dependency Check

   • Usage:
     • mvn verify to execute in standard maven lifecycle
     • mvn dependency-check:check to execute the plugin standalone
   • The dependency-check plugin will check dependencies for vulnerabilities against the National Vulnerability Database hosted by NIST and fail should there be any dependency with a CVSS score greater or equal to that specified in the pom file.
   • Maven plugin docs
   • OWASP Dependency Check docs
   • Continuous security and OWASP Dependency Check blog