This project is an implementation of a stateful, microservices based application that uses Oracle Coherence CE as a scalable embedded data store, and Helidon MP as application framework.
The application is an online store that sells socks, and is based on the SockShop Microservices Demo originally written and published under Apache 2.0 license by Weaveworks.
You can see a working demo of the original application here.
This demo still uses the original front end implementation provided by Weaveworks, but all back end services have been re-implemented from scratch using Helidon MP and Oracle Coherence, in order to showcase Coherence integration with Helidon, and Eclipse MicroProfile in general.
We also provide the implementations of the same application that use Spring Boot or Micronaut as the application framework, in case one of those is your framework of choice.
- Architecture
- Project Structure
- Pre-Requisites
- How to Run
- Complete Application Deployment
- Alternate Coherence Topologies
- Integrating with Oracle OCI Application Performance Monitoring (APM)
- Development
- License
The application consists of 6 back end services (rewritten from the ground up on top of
Helidon, implementing the API that the legacy front-end service expects).
-
Product Catalog, which provides REST API that allows you to search product catalog and retrieve individual product details;
-
Shopping Cart, which provides REST API that allows you to manage customers' shopping carts;
-
Orders, which provides REST API that allows customers to place orders;
-
Payment, which provides REST API that allows you to process payments;
-
Shipping, which provides REST API that allows you to ship orders and track shipments;
-
Users, which provides REST API that allows you to manage customer information and provides registration and authentication functionality for the customers.
You can find more details for each service within documentation pages for individual services, which can be accessed using the links above.
Each back end service described above has its own GitHub repo, so it can be versioned and released independently of other services.
In addition to that, there is also a main Sock Shop repository (the one you are currently in), which contains Kubernetes deployment files for the whole application, top-level POM file which allows you to easily build the whole project and import it into your favorite IDE, and a bash script that makes it easy to check out and update all project repositories at once.
- Latest version of
kubectlavailable from https://kubernetes.io/docs/tasks/tools/. - Docker or Rancher
- A remote or local Kubernetes cluster - Min 1.16+
- Maven 3.8+ and JDK 17
Kubernetes scripts depend on Kustomize, so make sure that you have a newer
version of kubectl that supports it (at least 1.16 or above).
The easiest way to try the demo is to use Kubernetes deployment scripts from this repo.
If you do, you can simply run the following command from the coherence-helidon-sockshop-sample directory.
- Install the Coherence Operator
Install the Coherence Operator using the instructions in the Coherence Operator Quick Start documentation.
- Installing a Back-end
Create a namespace in Kubernetes called sockshop.
kubectl create namespace sockshopInstall the back-end into the sockshop namespace.
kubectl apply -k k8s/coherence --namespace sockshopTIP: You can see the state of the pods using:
kubectl --namespace sockshop get podsWarning: The original WeaveSocks Front End has a few bugs, as well as some security issues, and it hasn't been actively maintained for a few years. However, if you want to deploy it nevertheless to see how it interacts with our back-end services, please follow the steps below.
Install the front-end service by running the following command:
kubectl apply -f k8s/optional/original-front-end.yaml --namespace sockshopPort-forward to the front-end UI using the following
kubectl port-forward --namespace sockshop service/front-end 8079:80Note: If you have installed into a namespace then add the
--namespaceoption to allkubectlcommands in these instructions.
You should be able to access the home page for the application by pointing your browser to http://localhost:8079/.
You should then be able to browse product catalog, add products to shopping cart, register as a new user, place an order, browse order history, etc.
Once you are finished, you can clean up the environment by executing the following:
kubectl delete -f k8s/optional/original-front-end.yaml --namespace sockshop
kubectl delete -k k8s/coherence --namespace sockshopIf you wish to scale the back-end you can issue the following command
Scale only the orders microservice
kubectl --namespace sockshop scale coherence/orders --replicas=3Or alternatively scale all the microservices
for name in carts catalog orders payment shipping users
do kubectl --namespace sockshop scale coherence/$name --replicas=3
doneThe How to Run above shows how you can run the application locally, but that may not be enough if you want to experiment by scaling individual services, look at tracing data in Jaeger, monitor services via Prometheus and Grafana, or make API calls directly via Swagger UI.
To do all of the above, you need to deploy the services into a managed Kubernetes cluster in the cloud, by following the same set of steps described above (except for port forwarding, which is not necessary), and performing a few additional steps.
Go to Complete Application Deployment section
If you want to modify the demo, you will need to check out the code for the project, build it locally, and (optionally) push new container images to the repository of your choice.
This project welcomes contributions from the community. Before submitting a pull request, please review our contribution guide
Please consult the security guide for our responsible security vulnerability disclosure process
The Universal Permissive License (UPL), Version 1.0