ABP vNext微服務架構詳細教程——身份管理服務


1.創建服務

ABP vNext創建包含app和module兩種模板,其中app方式所創建的模板包含用戶、角色、權限管理,ABP基礎配置IdentityServer的基礎配置數據等功能。module模式是一個比較干凈的服務,里面不包含默認業務功能。

這里我們構建身份管理服務,需要用到ABP vNext框架自帶的用戶角色管理模塊,所以采用app模式構建項目源碼。項目名稱為Demo.IdentityManager,構建命令如下:

abp new Demo.Identity -t app --ui none --separate-identity-server -dbms MySQL

 這里  -t app 表示application模式 ,--ui none 表示不使用UI界面, --separate-identity-server 表示將身份認證服務IdentityServer和當前項目服務分開, -dbms MySQL 表示使用MySQL數據庫

執行命令后,執行目錄中會出現aspnet-core文件夾,將該文件夾中所有內容拷貝至項目解決方案的service/identitymanager目錄下,將其中的IdentityServer項目移動至identityserver文件夾下,若直接添加IdentityServer項目到解決方案會報錯找不到common.props,這是因為相對路徑發生變化,可將identitymanager目錄下的common.props文件復制一份到總解決方案sln所在目錄

目錄調整完成后,使用sln構建工具添加所有項目到總解決方案。添加后項目結構如下圖:

因為IdentityServer項目相對路徑發生變化,需刪除並重新添加該項目對EntityFrameworkCore項目的引用。

如果不想使用ABP自帶的單元測試可以將解決方案文件夾test及其下項目刪除

2.初始化數據庫

在ABP vNext框架application模式代碼創建的數據庫中,會包含用戶、角色、權限、配置等功能的表,以及IdentityServer框架各項數據庫持久化數據的表。

application模式下所創建的項目中的DbMigrator項目包含創建、執行數據遷移並初始化數據的功能。

正常情況下我們修改DbMigrator項目的配置文件appsettings.json中的ConnectionStrings:Default字段改為我們所使用的數據庫並執行該項目,即可創建所需要的數據庫

但我當前所用版本6.0.1有一個小Bug,運行DbMigrator項目會卡在創建數據遷移這一步,需要我們修改數據庫鏈接字符串后手動創建數據遷移並執行,使用dotnet-ef命令執行如下:

  1. 在EntityFramework項目目錄下進入cmd命令行
  2. 確保dotnet-ef命令已安裝並更新至最新版本,具體可參考:https://docs.microsoft.com/zh-cn/ef/core/get-started/overview/install
  3. 添加數據遷移
    dotnet-ef migrations add InitDb
  4. 執行數據遷移
    dotnet-ef database update -s ..\Demo.Identity.DbMigrator

執行完成后,數據庫已創建成功,運行DbMigrator項目可完成數據初始化。

3.調整及測試

身份管理服務運行項目為Identity.HttpApi.Host,將此項目設置為啟動項。

修改Identity.HttpApi.Host項目中的配置文件appsettings.json,修改數據庫鏈接字符串:ConnectionStrings:Default,及Redis地址:Redis:Configuration,按照服務規划我們給該服務設置的規划的端口號為5000,所以在appsettings.json中添加配置項: "urls": "http://*:5000" 

默認情況下,ABP vNext框架自帶的用戶角色權限等接口需要授權用戶才可以訪問,依據我們之前的設計,微服務中的各項服務不需要二次權限驗證,這里我們全局忽略權限驗證,否則調用時會報401錯誤。忽略方法為在IdentityHttpApiHostModule的ConfigureServices方法中添加以下內容:

context.Services.AddAlwaysAllowAuthorization();

以控制台方式啟動項目Identity.HttpApi.Host項目,啟動完成后通過瀏覽器訪問http://localhost:5000/swagger/index.html,成功顯示Swagger頁面,測試/api/identity/users的Get方式接口,返回admin用戶信息,說明服務配置成功。


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM