微服務框架Demo.MicroServer運行手冊

来源:https://www.cnblogs.com/peyshine/archive/2020/07/07/13258328.html

一.背景說明: 之前分享過一個微服務開發框架, “享一個集成.NET Core+Swagger+Consul+Polly+Ocelot+IdentityServer4+Exceptionless+Apollo+SkyWalking的微服務開發框架”,前兩天在Github上收到一個Issues,是想我 ...


一.背景說明:

之前分享過一個微服務開發框架, “享一個集成.NET Core+Swagger+Consul+Polly+Ocelot+IdentityServer4+Exceptionless+Apollo+SkyWalking的微服務開發框架”,前兩天在Github上收到一個Issues,是想我這邊提供下完整的運行文檔和配置文件,因為之前想法是弄清楚這幾個東西的職責之後,對於運行的先後順序,和需要的配置key應該都會有瞭解,所以README編寫只是介紹了用到了哪些東西,沒有說如何運行,但是既然有人問起,我還是滿足一下,就當成是自己回顧了。

二.回顧下項目結構

項目結構比較簡單:

  • MicroServer.Instance文件夾下麵存放的是微服務實例,至於微服務顆粒度的拆分得結合實際的業務情況
  • Demo.MicroServer.IdentityServer4 統一鑒權中心
  • Demo.MicroServer.Infrastructure 基礎設施,可以自行在裡面添加內容
  • Demo.MicroServer.Ocelot 這一層是Api網關
  • Demo.MicroServer.Repository 通用的數據訪問層,包含MySQL,Mongo,Redis等,之所以抽離出來,是方便各個服務實例可是直接使用這些通用方法。

而上面說的 ".NET Core+Swagger+Consul+Polly+Ocelot+IdentityServer4+Exceptionless+Apollo+SkyWalking" 中有幾個東西還未出現,分別是 Consul,Polly,Exceptionless,Apollo,SkyWalking,這裡還是分別介紹下

  • Consul是一種服務網格解決方案,提供具有服務發現,健康檢查,Key/Value存儲,多數據中心等功能。在這裡我們主要使用到服務發現,健康檢查,啟動場景是:微服務實例啟動的時候
  • Polly是.NET彈性和瞬態故障處理庫,與Ocelot天然友好集成,使用也只需要在Ocelot 層添加少數配置即可使用
  • Exceptionless是一款開源的實時的日誌收集框架,可以使用線上或者本地搭建好的服務(如果只是本地測試建議直接使用線上的很方便),然後在微服務中配置好Url和應用的ApiKey就可以使用。
  • Apollo是攜程框架部門研發的分散式配置中心,能夠集中化管理應用不同環境、不同集群的配置,配置修改後能夠實時推送到應用端,並且具備規範的許可權、流程治理等特性,適用於微服務配置管理場景,搭建好Apollo服務後,我們代碼配置文件就可以變得相當乾凈了,只用留Apollo的配置就行,其他的配置幾乎全部可以放在Apollo裡面了。
  • SkyWalking 關於SkyWalking 我有一篇文章專門介紹了這個,這裡不在贅述,需要瞭解的可以查看:在微服務框架Demo.MicroServer中添加SkyWalking+SkyApm-dotnet分散式鏈路追蹤系統

三.安裝啟動微服務周邊應用

在運行服務之前,你或許可以先安裝或開啟以下幾個服務

  1. MySql
  2. Exceptionless
    如果還沒安裝可以參考:https://github.com/exceptionless/exceptionless/wiki/self-hosting ,建議使用docker安裝
  3. apollo
    如果還沒安裝,可以參考:https://github.com/ApolloAuto/apollo/blob/master/docs/quickstart/apollo_software_installation_guide_cn.md
  4. consul
    這個可以直接下載編譯好的文件,直接啟動就行
    ./consul agent -dev -data-dir=/data/consul -node=agent-1 -client=0.0.0.0 -bind=10.34.5.101 -datacenter=demo
  5. Skywalking
    請參考我之前的文章:在微服務框架Demo.MicroServer中添加SkyWalking+SkyApm-dotnet分散式鏈路追蹤系統

咋一看這麼多需要安裝啟動的是不是感覺很慌?
不用擔心,其實如果先排除身份驗證連資料庫都不用讀,可以只用安裝consul就可以,至於apollo可以先將配置寫在代碼的配置文件中,對於將項目跑起來這點來說apollo不是必須的,日誌收集也可以暫緩,性能檢測也一樣,我們可以先將核心的跑起來,再來完善他的周邊,秉著這個思路,我們開始運行

四.開始啟動

  1. 啟動consul

開發下我們可以這樣啟動consul服務:

./consul agent -dev -data-dir=/data/consul -node=agent-1 -client=0.0.0.0 -bind=10.34.5.101 -datacenter=demo

啟動之後的效果如圖:

  1. 啟動三個微服務實例

dotnet Demo.MicroServer.UserService.dll --urls="http://*:6891" --ip="本機ip" --port=6891
dotnet Demo.MicroServer.UserService.dll --urls="http://*:6892" --ip="本機ip" --port=6892
dotnet Demo.MicroServer.UserService.dll --urls="http://*:6893" --ip="本機ip" --port=6893

這裡演示,分別在6891,6892,6893三個埠啟動用戶的微服務實例,啟動之後,consul就開始工作了,如圖:

而Consul是如何發現服務的,其實得益於我們在服務裡面添加的一個擴展:

public static IApplicationBuilder UseConsul(this IApplicationBuilder app, IConfiguration configuration)
{
    ConsulClient _client = new ConsulClient(c =>
    {
        c.Address = new Uri(configuration["Consul.ServerUrl"]);
        c.Datacenter = "Demo.MicroServer";
    });

    string ip = configuration["ip"];
    int port = int.Parse(configuration["port"]);
    int weight = string.IsNullOrEmpty(configuration["weight"]) ? 1 : int.Parse(configuration["weight"]);

    _client.Agent.ServiceRegister(new AgentServiceRegistration()
    {
        ID = "UserService-" + Guid.NewGuid(),
        Name = "Demo.MicroServer.UserService",
        Address = ip,
        Port = port,
        Tags = new string[] { string.IsNullOrEmpty(configuration["tags"]) ? "" : configuration["tags"] },   //標簽
        Check = new AgentServiceCheck()                                                                     //健康檢查
        {
            Interval = TimeSpan.FromSeconds(10),                                                            //每隔多久檢測一次
            HTTP = $"http://{ip}:{port}/api/health/check",
            Timeout = TimeSpan.FromSeconds(5),
            DeregisterCriticalServiceAfter = TimeSpan.FromSeconds(60)                                       //在遇到異常後關閉自身服務通道
        }
    });

    return app;
}

併在StartUp.cs中使用了他:app.UseConsul(Configuration);

其實到這裡,項目就已經跑起來了,並且具備初步的負載均衡功能,我們可以通過這三個埠其中任意一個來調用服務都是可以的。凡是都有但是,難道要人為去配置什麼場景使用哪個ip和埠的服務嗎,或者說要將我們所有的服務都暴露出去嗎,每個服務都加一套登錄鑒權機制嗎?想想都覺得很可怕,那麼怎麼解決這個問題呢,答案就是.Net 中常用的APi GateWay之:Ocelot

  1. 啟動網關Ocelot

開始啟動Ocelot層:dotnet Demo.MicroServer.Ocelot.dll
網關啟動之後就可以通過網關的ip去訪問任意被註冊過的服務,前提是在網關層中有配置好協議,以下麵兩個為例子,一個是swagger,一個是用戶服務

//swagger
{
  "DownstreamPathTemplate": "/doc/Demo.MicroServer.UserService/swagger.json",
  "DownstreamScheme": "http",
  "ServiceName": "Demo.MicroServer.UserService",
  "LoadBalancer": "RoundRobin",
  "UseServiceDiscovery": true,
  "UpstreamPathTemplate": "/doc/Demo.MicroServer.UserService/swagger.json",
  "UpstreamHttpMethod": [ "GET", "POST", "DELETE", "PUT" ]
},
//UserService
{
  "DownstreamPathTemplate": "/api/{url}",
  "DownstreamScheme": "http",
  "UpstreamPathTemplate": "/api/{url}",
  "UpstreamHttpMethod": [ "Get", "Post", "DELETE", "PUT" ],
  "ServiceName": "Demo.MicroServer.UserService",
  "UseServiceDiscovery": true,
  "LoadBalancerOptions": {
    "Type": "RoundRobin"
},

由於每個服務中都已經配置好了swagger文檔,所以這裡只需要指定路由協議,一樣的可以通過網關來訪問swagger
這裡可以通過網關的ip和埠訪問swagger和userservice服務

截止到這裡服務的註冊與發現還有網關的上下游配置基本完成,但是圍繞在網關層的東西有很多,例如緩存,限流,熔斷器,在網關層統一鑒權等等,但是這些不是當前要討論的,這個具體根據後續反饋再看是否要單獨拿出來解釋.

五.Apoll配置

上面介紹了運行啟動流程,根據需求,這裡也貼一下apollo總的配置項,而網關層和用戶服務層的配置在appsetting中有配置,代碼中已經都有了,這裡著重貼下apollo中的配置

  1. Demo.MicroServer.Ocelot 層在apollo中的配置:
Swagger.ServiceDocNames = Demo.MicroServer.UserService,Demo.MicroServer.ProductService
IdentityService4.Uri = http://localhost:5000
IdentityService4.UseHttps = false

如圖:

  1. Demo.MicroServer.UserService 層在apollo中的配置:
MySqlConnections = server=mysql_ip;port=3306;database=demo_microserver;User Id=root;pwd=123456;charset=utf8
Swagger.Name = Demo.MicroServer.UserService
Swagger.Version = v1
Swagger.DocName = Demo.MicroServer.UserService
Swagger.Title = Api interface documentation
Swagger.Description = See below for specific interface
Swagger.Contact.Name = PeyShine
Swagger.Contact.Email = [email protected]
Swagger.XmlFile = Demo.MicroServer.UserService.xml
Exceptionless.ApiKey = LmqMIxSTW0U68pKwJ3xXqrNrLqS6oEociW7OexNt
Exceptionless.ServerUrl = http://exceptionless_ip:5000
Consul.ServerUrl = http://consul_ip:8500
MongoDB.DefaultConnection = mongodb://dev:[email protected]_ip/demo_db
MongoDB.DefaultDatabase = demo_db
MongoDB.DefaultTable = users

如圖:

六.總結

本文作為文章"分享一個集成.NET Core+Swagger+Consul+Polly+Ocelot+IdentityServer4+Exceptionless+Apollo+SkyWalking的微服務開發框架"的一個補充擴展,主要是介紹如何一步步啟動Demo.MicroServer微服務框架,裡面關於網關還有IdentityServer4沒有進行深入討論,想法是只要能先將項目核心部分跑起來,周邊應用可以自行添加,後續再根據反饋是否要更加詳細的去介紹。
其實理解了幾個開源項目自己的職責之後,對運行流程就不難理解了,動手試試吧!

文章代碼在Github中的地址:https://github.com/PeyShine/Demo.MicroServer,歡迎star


您的分享是我們最大的動力!

更多相關文章
  • 前言 面試總是會被問到有沒有用過分散式鎖、redis 鎖,大部分讀者平時很少接觸到,所以只能很無奈的回答 “沒有”。本文通過 Spring Boot 整合 redisson 來實現分散式鎖,並結合 demo 測試結果。 首先看下大佬總結的圖 正文 添加依賴 <!--redis--> <depende ...
  • 本文屬於OData系列 目錄 武裝你的WEBAPI-OData入門 武裝你的WEBAPI-OData便捷查詢 武裝你的WEBAPI-OData分頁查詢 武裝你的WEBAPI-OData資源更新Delta 武裝你的WEBAPI-OData之EDM 武裝你的WEBAPI-OData常見問題 武裝你的WE ...
  • abp版本5.9 概述 數據遷移無非就是兩件事情,1、創建資料庫,並根據實體創建對應的表;2、添加一些初始數據 abp的數據遷移也是完成這兩件事,比較特殊的是它是多租戶saas系統,而且支持不同的租戶有獨立的資料庫。所以abp中的遷移要先遷移戶主Host,再遷移租戶Tenant的資料庫 它的遷移定義 ...
  • 前言 上一篇文章主要介紹了IL的概念以及基礎的示例代碼,在這一篇文章中我們將通過對象調用看IL。 創建對象與調用方法 class Program { static void Main(string[] args) { var obj = new MyClass(); Console.WriteLin ...
  • 找到項目中ServiceStack.Text.dll文件的版本,比如我的版本是5.0.0,到GitHub上下載對應的源碼(https://github.com/ServiceStack/ServiceStack.Text/tags) 打開解決方案,重新生成ServiceStack.Text項目,如果 ...
  • 1.需求示意圖 2.需求描述 原本是為了給做unity3d客戶端開發的同事提供不定時的消息推送,比如商城購買道具後服務端將道具信息推送給客戶端。 本篇文章簡化理解,用“相關部門開展活動,向全市人民徵集社會服務改善意見”為例子。但核心想法一致:單向推送(指這個需求上只需要單向)。所以這個功能並不是聊天 ...
  • 本人製作的這個 “簡易日誌 (SimpleLogger)” 包裡面包含的代碼邏輯,最開始也就是簡單地寫入文本,後來經過實際使用的演化,做了各種優化,添加了一些實用的特性,感覺用著還不錯。正所謂獨樂樂不如眾樂樂,於是將其打包上傳到微軟的包管理庫 NuGet 中,大家可以使用試試,相互交流。 ...
  • 前言 Http我們都已經耳熟能詳了,而關於Http學習的文章網上有很多,各個知識點的講解也可說是深入淺出。然而,學習過後,我們對Http還是一知半解。問題出在了哪? Http是一個客戶機與伺服器之間的通信的協議,真的想學習Http,就必須把客戶機和伺服器也學了,也就是說,必須立體的學習,不然我們永遠 ...
一周排行
  • 比如要拆分“呵呵呵90909086676喝喝999”,下麵當type=0返回的是中文字元串“呵呵呵,喝喝”,type=1返回的是數字字元串“90909086676,999”, private string GetStrings(string str,int type=0) { IList<strin ...
  • Swagger一個優秀的Api介面文檔生成工具。Swagger可以可以動態生成Api介面文檔,有效的降低前後端人員關於Api介面的溝通成本,促進項目高效開發。 1、使用NuGet安裝最新的包:Swashbuckle.AspNetCore。 2、編輯項目文件(NetCoreTemplate.Web.c ...
  • 2020 年 7 月 30 日, 由.NET基金會和微軟 將舉辦一個線上和為期一天的活動,包括 微軟 .NET 團隊的演講者以及社區的演講者。本次線上大會 專註.NET框架構建微服務,演講者分享構建和部署雲原生應用程式的最佳實踐、模式、提示和技巧。有關更多信息和隨時瞭解情況:https://focu... ...
  • #abp框架Excel導出——基於vue #1.技術棧 ##1.1 前端採用vue,官方提供 UI套件用的是iview ##1.2 後臺是abp——aspnetboilerplate 即abp v1,https://github.com/aspnetboilerplate/aspnetboilerp ...
  • 前言 本文的文字及圖片來源於網路,僅供學習、交流使用,不具有任何商業用途,版權歸原作者所有,如有問題請及時聯繫我們以作處理。 作者:碧茂大數據 PS:如有需要Python學習資料的小伙伴可以加下方的群去找免費管理員領取 input()輸入 Python提供了 input() 內置函數從標準輸入讀入一 ...
  • 從12年到20年,python以肉眼可見的趨勢超過了java,成為了當今It界人人皆知的編程語言。 python為什麼這麼火? 網路編程語言搜索指數 適合初學者 Python具有語法簡單、語句清晰的特點,這就讓初學者在學習階段可以把精力集中在編程對象和思維方法上。 大佬都在用 Google,YouT ...
  • 在社會上存在一種普遍的對培訓機構的學生一種歧視的現象,具體表現在,比如:當你去公司面試的時候,一旦你說了你是培訓機構出來的,那麼基本上你就涼了,那麼你瞞著不說,然後又通過了面試成功入職,但是以後一旦在公司被髮現有培訓經歷,可能會面臨被降薪,甚至被辭退,培訓機構出來的學生,在用人單位眼裡就是能力低下的 ...
  • from typing import List# 這道題看了大佬寫的代碼,經過自己的理解寫出來了。# 從最外圍的四周找有沒有為O的,如果有的話就進入深搜函數,然後深搜遍歷# 判斷上下左右的位置是否為Oclass Solution: def solve(self, board: List[List[s ...
  • import requests; import re; import os; # 1.請求網頁 header = { "user-agent":'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/537.36 (KHTML, li ...
  • import requests; import re; import os; import parsel; 1.請求網頁 header = { "user-agent":'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/537. ...