This is a template project based on eShopOnAbp with minimal configuration and services, ready to be used as a template to create new, fresh, microservices architectures.
Currently the Tye runner contains the following features:
- Angular application;
- Example service as ABP Framework module;
- Example service gateway using YARP;
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.
- .NET 7.0+
- Docker
- Yarn
-
Clone the repository ( eShopOnAbp )
-
Install Tye (follow these steps)
-
Rename
.env.example
file to.env
. -
Execute
run-tye.ps1
-
Wait until all applications are up!
- You can check running application from tye dashboard (localhost: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 with SSL, developer certificate creation may have failed because of powershell issues regarding authorization. Check the powershell script running configuration and set policy for your local machine as:
Get-ExecutionPolicy -list Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine
See Microsoft Powershell documentation for more information.
-
After all your backend services are up, start the angular application:
cd apps/angular yarn start
If the cerficiate is expired you'll see following error:
Generating a new certificate will fix that issue. To generate new one,
- Remove
etc/dev-cert/localhost.pfx
- Manually execute
create-certificate.ps1
or re-run solution withrun-tye.ps1