Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/abpframework/eShopOnAbp
Reference microservice solution built with the ABP Framework and .NET, runs on Kubernetes with Helm configuration, includes API Gateways, Angular and ASP.NET Core MVC applications, PostgreSQL and MongoDB databases
https://github.com/abpframework/eShopOnAbp
api-gateway asp-net-core aspnetcore csharp ddd gateway kubernetes microservices microservices-architecture spa
Last synced: 3 months ago
JSON representation
Reference microservice solution built with the ABP Framework and .NET, runs on Kubernetes with Helm configuration, includes API Gateways, Angular and ASP.NET Core MVC applications, PostgreSQL and MongoDB databases
- Host: GitHub
- URL: https://github.com/abpframework/eShopOnAbp
- Owner: abpframework
- License: mit
- Created: 2021-06-10T06:52:21.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-02-22T02:15:15.000Z (4 months ago)
- Last Synced: 2024-03-25T21:33:06.142Z (3 months ago)
- Topics: api-gateway, asp-net-core, aspnetcore, csharp, ddd, gateway, kubernetes, microservices, microservices-architecture, spa
- Language: C#
- Homepage: https://www.eShopOnAbp.com/
- Size: 21 MB
- Stars: 629
- Watchers: 36
- Forks: 234
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Roadmap: docs/roadmap/Phase_1.png
Lists
- awesome-microservice-demo - eShopOnAbp - abpframework/eShopOnAbp
README
# eShopOnAbp
This is a reference project for those who want to build microservice solutions with the ABP Framework.
See [the blog post](https://blog.abp.io/abp/Introducing-the-eShopOnAbp-Project) for more info.
Live demo 👉 https://www.eshoponabp.com/
## Issues
Please open issues on the main GitHub repository: https://github.com/abpframework/abp/issues
## How to Run?
You can run it in Visual Studio or use [Microsoft Tye](https://github.com/dotnet/tye). Tye is a developer tool that makes developing, testing, and deploying micro-services and distributed applications easier.
### Requirements
- .NET 7.0+
- Docker
- Yarn
### Instructions
- Clone the repository ( [eShopOnAbp](https://github.com/abpframework/eShopOnAbp) )
- Install Tye (*follow [these steps](https://github.com/dotnet/tye/blob/main/docs/getting_started.md#installing-tye)*)
- Rename `.env.example` file to `.env` file and provide PayPal ClientID and Secret.
- Execute `run-tye.ps1`
- Wait until all applications are up!
- You can check the running application from `tye` dashboard ([localhost:8000](http://127.0.0.1:8000/))
- **Note**: If you see all of your applications keep restarting on `tye` dashboard or `tye` console, you may be facing SSL certificate issues. To diagnose the problems better, check any application logs. If it is related to SSL, developer certificate creation may have failed because of Powershell issues regarding authorization. Check the PowerShell script running configuration and set the policy for your local machine as follows:
```bash
Get-ExecutionPolicy -list
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine
```
See [Microsoft Powershell documentation](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.security/get-executionpolicy?view=powershell-7.2) for more information.
- After all your backend services are up, start the angular application:
```bash
cd apps/angular
yarn start
```
### Certificate Expiration
If the certificate is expired, you'll see the following error:
Generating a new certificate will fix that issue. To generate a new one,
- Remove `etc/dev-cert/localhost.pfx`
- Manually execute `create-certificate.ps1` **or** re-run solution with `run-tye.ps1`
## Roadmap
### Version 1.0
- [x] New blank micro-service solution ✔️
- [x] Creating Deployment Scenarios ✔️
- [x] Creating empty business services ✔️
- [x] Implementing business logic into services ✔️
- [x] Payment with PayPal ✔️
- [x] Basket, Catalog, Order Service ✔️
- [x] Docker Image creation ✔️
- [x] Helm deployment for local k8s cluster ✔️
- [x] Switch Ocelot to Envoy YARP in Public Web gateway ✔️
- [x] Use gRPC for catalog microservice ✔️
- [x] Management Side of Services ✔️
- [x] Administration application (to manage products and orders with a dashboard) ✔️
- [x] Deployment to azure k8s ✔️ (https://eshoponabp.com)
### Version 2.0
- [x] Product-detail page on the shopping application (with CMS-kit integration for comments and rating components) ✔️
- [x] Switch to Keycloak from IdentityServer in AuthServer
- [ ] Re-design authorization/permission management
- [ ] Integrate a new sample microservice written in GoLang (Or Python / Java)
### Documentation
- [ ] We will create an e-book to explain the solution
## Current Architecture
## ABP Community Talks
We've organized a meetup related to this solution. You can watch it here: https://community.abp.io/events/microservice-development-iv7d46ov