nicc777 / java-conversions-app

A Spring Boot REST application for various conversions, for example temperature conversions from Celsius to Fahrenheit.

java-conversions-app

A Spring Boot REST application for various conversions, for example temperature conversions from Celsius to Fahrenheit.

This is a demonstration project for the Kubernetes from scratch guide.

Please refer to the guide for more details.

The initial state of this repository is in the branch called initial_copy. The intention is to introduce all changes in appropriate branches in order for users to track changes.

Unit Tests

Running the unit test:

./mvnw clean && ./mvnw test

Generate the coverage report in HTML:

./mvnw jacoco:report

Expose the coverage report on a web server to view on a remote system:

cd target/site/jacoco
python3 -m http.server

Same as above, but on a custom port 9999:

python3 -m http.server 9999

Trigger a release build (new application version)

Update the following:

• Bump the version in pom.xml
• Update the version in conversions-chart/values.yaml in parameter named application_container_version to match application version as defined in pom.xml
• In the file conversions-chart/Chart.yaml update:
  • Bump the version (this is the Helm version)
  • Ensure the appVersion is the same value as defined in pom.xml

Remember to push to the v2 (or v1) branch, but note that the actions may fail sine there is already a release:

Store the version value in the environment variable VERSION. Then commit and push.

export VERSION=2.x.x
git add .
git commit -m "chore: bumped to version $VERSION"
git tag -a v$VERSION -m "Release trigger for version ${VERSION}"
git push origin v2

# Wait until the Git Action completes....
git push origin --tags

Helm Chart Updates

Important: If you make changes to the Helm Charts, also remember to update the version in the file charts/conversions-chart/Chart.yaml.

When you push to the release branch, a new build will be made, and any changes to the Helm configuration will now trigger a new Helm release.