A Java Maven Calculator Web App

A Java calculator web app, build by Maven, CI/CD by Jenkins.

image from https://jenkins.io/doc/book/pipeline/

1. Manualy Build, Test, and Deploy By Maven

1.1 Build

mvn clean package

1.2 Run Locally

mvn jetty:run

By default, the jetty port is 9999, so you should visit following urls in browser:

http://localhost:9999/calculator/api/calculator/ping

http://localhost:9999/calculator/api/calculator/add?x=8&y=26

http://localhost:9999/calculator/api/calculator/sub?x=12&y=8

http://localhost:9999/calculator/api/calculator/mul?x=11&y=8

http://localhost:9999/calculator/api/calculator/div?x=12&y=12

To run in a different port

mvn jetty:run -Djetty.port=<your port>

1.3 Debug Locally

set MAVEN_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,address=8000,suspend=n
mvn jetty:run

1.4 Run JUnit Test

mvn clean test

1.5 Run Integration Test

mvn clean integration-test

1.6 Deploy Your Web App to An Existed Tomcat 8x

You need change pom.xml, point to your Tomcat 8x.

mvn cargo:run

1.7 Run Performance Test with JMeter

You need install Jmeter first, and make sure your Tomcat 8x is runing.

mvn clean verify

To run in command line mode with parameters

./bin/jmeter.sh -n -t ./tests/CalculatorTestPlan.jmx -Jusers=20 -Jloop=2 -l ./results/calculator_`date +'%y%m%d%H%M%S'`.cs

1.8 Build Project Site

mvn site

2. Automaticly Build, Test, and Deploy By Jenkins

2.1 Create and Configure a Freestyle Jenkins Project

Project name: MyJavaMavenCalculateWebApp

Execute every mvn goal one by one defined in Build Section Step: "Invoke top-level Maven targets"

2.2 Create and Configure a Freestyle Jenkins Project, using Publish Over FTP plugin

Project name: MyJavaMavenCalculateWebApp-AzureAppService-FTP

2.3 Create and Configure a Freestyle Jenkins Project, using Azure App Service plugin

Project name: MyJavaMavenCalculateWebApp-AzureAppService

2.4 Create and Configure a Pipeline Jenkins Project

Project name: MyJavaMavenCalculateWebApp-Pipeline

Execute the Jenkins Pipeline Script File: Jenkinsfile

3. Containerize Your Web App

Build a docker image using Dockerfile:
```
docker build -t calculator .
```

Run docker image locally

docker run --rm -p 8080:8080 calculator

Then you can access the web app at http://localhost:8080/api/calculator/ping in browser

Stop container

docker ps -a
docker stop <Container-ID>

Push your local image to your docker hub repositories

docker login -u <Your-Docker-ID> -p <Your-Docker-Password>
docker tag calculator <Your-Docker-ID>/calculator
docker push <Your-Docker-ID>/calculator

4. Deploy to Azure Web App using Container Image in Docker Hub

Create a Web App in Linux on Azure
Save the changes and you'll be able to access the web app in a few seconds.

5. Deploy to Your Azure Web App using Container Image in ACR

Create a Container Registry on Azure

Push your local image to ACR:

docker login <Your-ACR-Login-Server> -u <Your-ACR-Username> -p <Your-ACR-Password>
docker tag calculator <Your-ACR-Login-Server>/calculator
docker push <Your-ACR-Login-Server>/calculator

Create a Web App in Linux on Azure
In Docker Container settings of Web App, fill in image name, server URL, username and password of your ACR.
Save the changes and you'll be able to access the web app in a few seconds.

ravdy/java-maven-calculator-web-app