Introducing the eShopOnAbp Project

User Avatar
3 years ago, 15929 views, 5 comments
Cover Image

We are happy to introduce the eShopOnAbp project as an example microservice solution built with the ABP Framework by the core ABP team. This solution demonstrates the strength of ABP Framework and using it in a real-life case. The goal of the project is to create a full-featured cloud-native microservices reference application. The project is inspired by the eShopOnContainers project and shows how it can be implemented with the ABP Framework.

Project Status: Currently, the project doesn't have any business logic. We've just brought ABP's pre-built modules (Identity, Tenant Management, IdentityServer, etc) together as a base solution. However, it is fully working and you can now take it as a base solution for your microservice project. From now on, we will build the example application functionalities / business logic on top of it.

Source Code

The source code is available on abpframework/eShopOnAbp repository.

The Big Picture

The project follows micro-service architecture and overall structure is presented below.

overall-solution.png

How to Run?

You can either run in Visual Studio, or using Microsoft Tye. Tye is a developer tool that makes developing, testing, and deploying micro-services and distributed applications easier.

Requirements

  • .NET 5.0+
  • Docker
  • Yarn

Instructions

  • Clone the repository ( eShopOnAbp )

  • Install Tye (follow these steps)

  • Execute run-tye.ps1

  • Wait until all applications are up!

    • You can check running application from tye dashboard (localhost:8000)
  • After all your backend services are up, start the angular application:

    cd apps/angular
    yarn start
    

What's Next?

We'll work on deployment & CI-CD processes as a next step and build the business logic on. First goal is deploying the entire application on Kubernetes.

Feedback

Your comments and suggestions is important for us. You can ask your questions or post your feedback under this discussion entry.

5 comments

Leave Comment
User Avatar
waqarkabir 1 month ago

Very nice but could be more detailed one

User Avatar
eng.rubaal7asan@gmail.com 1 year ago

Hi guys, live demo not working 504 error is appearing, could you check please

User Avatar
stefan.gabor1@gmail.com 2 years ago

This is a great project. Do you guys have something plan to add new microservices automatically? A little bit like adding new modules.

User Avatar
joe@tronactive.com 3 years ago

How close are you guys on the documentation to deploy on Kubernetes? I am trying to get this to work right now but having issues.

User Avatar
MaxRiz 3 years ago

awesome!