In parallel computing, fork–join is a way of setting up and executing parallel programs, such that execution branches off in parallel at designated points in the program, to "join" (merge) at a subsequent point and resume sequential execution. Parallel sections may fork recursively until a certain task granularity is reached. Fork–join can be considered a parallel design pattern.
| Name | Port | Description |
|---|---|---|
| bank-service | 9001 | Spring Boot Microservice |
| user-service | 9000 | Spring Boot Microservice |
| fork-join-demo | 4200 | Angular App |
| api-gateway | 9500 | Zuul API Gateway |
clone the repository based on below maintained versions.
| Branch/Version | Angular | Spring Boot | Spring Cloud |
|---|---|---|---|
| master | 7.0.0 | 2.1.2.RELEASE | Greenwich.RELEASE |
| v1.0 | 5.0.2 | 2.0.3.RELEASE | Finchley.RELEASE |
| v2.0 | 6.0.0 | 2.1.0.RELEASE | Greenwich.RELEASE |
- Clone the repository
git clone https://github.com/BarathArivazhagan/fork-join-springboot-angular.git
- Execute below script to build all the applications
cd fork-join-springboot-angular
./build.sh
- On windows, navigate to each applications and perform maven/webpack build
cd fork-join-springboot-angular
cd api-gateway
./mvnw clean package
cd bank-service
./mvnw clean package
cd user-service
./mvnw clean package
cd fork-join-demo
npm install
npm run build
- Start the applications
cd fork-join-springboot-angular
cd api-gateway
./mvnw spring-boot:run
cd bank-service
./mvnw spring-boot:run
cd user-service
./mvnw spring-boot:run
cd fork-join-demo
npm run start
Take advantage of docker compose to quickly build and run applications as containers.
- Build docker images
docker-compose build
- Run the applications
docker-compose up
To deploy the applications as docker containers inside kubernetes cluster
$ git clone https://github.com/BarathArivazhagan/fork-join-springboot-angular.git && cd fork-join-springboot-angular
$ kubectl create -f k8s/fork-join-deployment-k8s.yaml
configmap/spring-config-map created
configmap/api-gateway-config-map created
deployment.apps/user-app created
deployment.apps/bank-app created
deployment.apps/fork-join-api-gateway created
deployment.apps/fork-join-demo-app created
service/fork-join-api-gateway created
service/bank-service created
service/user-service created
service/fork-join-ui created
To deploy the applications as docker containers in openshift cluster
$ git clone https://github.com/BarathArivazhagan/fork-join-springboot-angular.git && cd fork-join-springboot-angular
$ oc login # login into a project
$ oc create -f openshift/fork-join-openshift-deployment.yaml
configmap "spring-config-map" created
configmap "api-gateway-config-map" created
deploymentconfig "user-service" created
deploymentconfig "bank-service" created
eploymentconfig "api-gateway" created
deploymentconfig "fork-join-angular" created
imagestream "bank-service" created
imagestream "user-service" created
imagestream "api-gateway" created
imagestream "fork-join-angular" created
service "api-gateway" created
service "bank-service" created
service "user-service" created
service "fork-join-angular" created
Note: Angular app uses nginx to serve static files. To run nginx as non root user in openshift, use fork-join-demo/Dockerfile.openshift to build angular app.
oc new-project dev --display-name="Dev"
oc new-project stage --display-name="Stage"
oc new-project cicd --display-name="CI/CD"
oc policy add-role-to-group edit system:serviceaccounts:cicd -n dev
oc policy add-role-to-group edit system:serviceaccounts:cicd -n stage
To setup cicd project
$ oc project cicd
$ oc process -f https://raw.githubusercontent.com/siamaksade/openshift-cd-demo/ocp-4.3/cicd-template.yaml | oc create -f -
$ oc import-image postgresql:9.6 --from=postgres:9.6 --confirm -n openshift
$ oc import-image jenkins:2 --from=quay.io/openshift/origin-jenkins:latest --confirm -n openshift
$ oc import-image jenkins-agent-nodejs:latest --from=quay.io/openshift/origin-jenkins-agent-nodejs:latest --confirm -n cicd
$ oc import-image jenkins-agent-maven:latest --from=quay.io/openshift/origin-jenkins-agent-maven:latest --confirm -n cicd
$ oc import-image jenkins-agent-base:latest --from=quay.io/openshift/origin-jenkins-agent-base:latest --confirm -n cicd
$ oc apply -f jenkins-configMaps.yaml
Note: Use Jenkins image that is imported above and create a deployment using that image and change the route that is created by default to use port 8080 instead of 50000
username is admin and password - password when using jenkins image from quay.io
Modify the route of Jenkins if the host does not work on browser
Need to add NodeJS tool if quay jenkins slaves doesn't work.
To setup Dev and Stage application
install git
git clone https://github.com/parkarteam/fork-join-springboot-angular.git && cd fork-join-springboot-angular
$ oc login # login into a project
$ oc project dev
$ oc create -f openshift/fork-join-openshift-deployment.yaml
$ oc project stage
$ oc create -f openshift/fork-join-openshift-deployment.yaml
$ oc import-image nginxbase--from=nginx:alpine --confirm -n dev
$ oc import-image bank-service:dev --from=ravirajk1007/fork-join-springboot-angular_bank-service:latest --confirm -n dev
$ oc import-image user-service:dev --from=ravirajk1007/fork-join-springboot-angular_user-service:latest --confirm -n dev
$ oc apply -f ui-build-config.yaml
Create an image stream on dev from console with name as 'ui-build'
Change the deployment config to use the image build by pipeline for angular app i.e. ui-build:latest Modify the image used in the deployment config for bank service app to use image bank-service:dev in openshift Modify the image used in the deployment config for user service app to use image user-service:dev
To setup Jenkins build pipeline, execute the below command on cicd project
oc apply -f build-pipeline.yaml
To setup PVC
create a file share in Azure and apply storageclass, secret, pv and pvc and mount it to the desired application. OR create storage class for azure-disk for jenkins pvc
# Create a storage class with azure disk name with following configurations/parameters:
Name: azure-disk
IsDefaultClass: No
Annotations: description=azure disk
Provisioner: kubernetes.io/azure-disk
Parameters: kind=managed,storageaccounttype=Standard_LRS
AllowVolumeExpansion: <unset>
MountOptions: <none>
ReclaimPolicy: Delete
VolumeBindingMode: Immediate
Events: <none>
$ Create pvc for that storage class and use it for jenkins
$ create a route for gateway app based on the url from network tab from UI console
To delete all the resources created in openshift
$ oc delete dc --all && oc delete svc --all && oc delete configmaps --all