Share an API Gateway project based on ABP and yarp

　 This project originated last year when the company tried to build a project with microservices , In the technical selection of gateway , We originally confirmed ApiSix gateway , If you need to write a gateway plug-in, you need to be based on Lua Script to write , Another colleague and I wrote a simple plug-in based on this , But development testing and release are troublesome , And use Lua Script as a plug-in development language itself is not our strength .

      Later, I learned through other channels that Microsoft has produced a reverse proxy component Yarp, And some people have done some projects based on it , So I decided to build a simple one based on it Api gateway , It's good to be able to meet basic needs .

      Project technology use :

      Development platform ：.Net 6 + MySql

      Development framework ：Abp Vnext 5.3.2

      Reverse proxy component : Yarp ( Official documents :https://microsoft.github.io/reverse-proxy/index.html)

      Background management ：Blazor (Bootstrap Blazor UI: https://www.blazor.zone)

　  Other components : Dto mapping （Mapster）、 The logging component （Serilog）

     Open source address (GitHub): https://github.com/yupingyong/kite.gateway

      notes : This article will rarely show the code implementation itself

　   One . Project structure chart ( And layer dependency descriptions ):

     

　　Kite.Gateway.Admin : Back office management projects , Realize the management of gateway service node and gateway configuration data , Support to synchronously refresh configuration data like multiple nodes

　　Kite.Gateway.Hosting : Gateway startup project , Define the gateway filter and middleware

　　Kite.Gateway.Application : Application service layer , Combine business logic layer business , Submit the database to save

　　Kite.Gateway.Application.Contracts : Application service public contract layer , Define the application service layer interface ,DTO object

　　Kite.Gateway.Domain: Domain services , Business logic processing core layer

　　Kite.Gateway.Domain.Shared : Domain service sharing layer , Define public enumerations , General tools, etc

　　Kite.Gateway.EntityFrameworkCore : Storage implementation layer , Rely on Domain Services , be based on EF Core Realization

　　 Two . Introduction to gateway execution process ( With pictures ):

　　

       Description of gateway middleware , The previous version was designed to utilize Abp Bring your own plug-in mechanism to realize , But in this edition, I have removed this design pattern . Why cancel the plug-in design pattern , I just feel that this gateway will lead to too deep correlation of specific businesses , In the new version, I use the gateway to initiate business services according to the configured middleware information Http Request or Grpc( Temporary unrealized ) The way to achieve , This reduces the dependence of the business on the gateway system , And the gateway's deep dependence on specific services .

        3、 ... and . Background management introduction ( There will be more renderings ):

　　

       1. Account management : Account management of login background management ( If it is newly installed, it can be used admin/admin Log in )

　　

       2. Node management : Gateway deployment node , Background management can push configuration dynamic refresh to nodes , It can take effect in time

　　

 　　

       3. Service governance configuration : Consul Information configuration , At present, we support Consul As a service governance middleware

　　

       4. Authentication configuration : Jwt Verification configuration , Support custom keys and SSL Certificate is in progress token check

　　

       5. White list configuration : Gateway filters the white list , When the request address appears in the white list , It won't go on token check

       6. Routing management : Yarp Reverse proxy component information configuration , Support the configuration of routing information 、 Cluster information 、 Health check information 、 Load balancing policy information

　　

　　7. Middleware management : Configure middleware information

　　

  notes : More functions , You can run the actual test locally after downloading the source code .