淺談surging服務引擎中的rabbitmq組件和容器化部署

1、前言

上個星期完成了surging 的0.9.0.1 更新工作，此版本通過nuget下載引擎組件，下載后，無需通過代碼build集成，引擎會通過Sidecar模式自動掃描裝配異構組件來構建服務引擎，而這篇將介紹淺談surging服務引擎中的rabbitmq組件和容器化部署

surging源碼下載

2、Sidecar模式

　　比如現在比較火的Service Mesh， 談到Service Mesh，就不得不了解下Sidecar模式，Sidecar設計模式被越來越多的關注和采用，此模式之所以稱作Sidecar，是因為它類似於三輪摩托車上的挎斗。 在此模式中，挎斗附加到應用程序中，為應用程序提供支持性功能。挎斗與應用程序具有相同的生命周期：與應用程序一起創建，一起停用。 挎斗模式有時也稱為搭檔模式，這是一種分解模式。而surging 采用了Sidecar模式用來附加組件，而使用Sidecar模式有以下功能

•     共享存儲空間

　     引擎組件部署到共享的文件目錄里，服務引擎從共享的文件目錄掃描引擎組件文件。

•    共享組件和業務的配置文件

        針對於組件的配置文件部署到共享的文件目錄里，服務引擎從共享的文件目錄加載文件。

•   獨立的業務服務

        針對於業務可以把依賴的組件打包部署到共享的文件目錄里，服務引擎從共享的文件目錄掃描加載，從而部署成獨立的業務服務

•    內置多種協議

        針對於獨立部署的業務服務，內置了多種協議，提供給服務和外部程序進行調用

      模式特點

• 隔離：讓組件都能夠關注核心問題。比如eventbus、Logger、 netty 在實現功能的同時無需關注其它組件的實現而發生的沖突；

• 單一責任原則：每個組件都應該職責分開，而根據這一原則，職責應該是對應一個類、模塊或者接口，從而能夠獨立進行處理。

• 內聚性/可重用性：針對組件的特性，方法可以進行重用，從而滿足組件可持續擴展。

3、基於Event Bus 的Rabbitmq組件

       surging服務引擎擴展了基於eventbus 的rabbitmq ，組件可以選擇綁定 Normal，Retry(Dead letter)，Fail ，如下圖所示。

       而針對於該組件有哪些應用場景呢？

• 商品秒殺和搶購

        搶購/秒殺是如今很常見的一個應用場景，在高並發的流量訪問下可以將用戶放入到搶購隊列中，購買成功則銷毀消息。

• 最終數據的一致性

       在大型業務中，系統一般由多個獨立的服務組成，在分布式調用時候把消息放入到rabbitmq 隊列中，再通過消息的冪等性來解決數據的最終一致性

•  訂單失效處理

       在購買商品/服務生成訂單業務中，會設定支付時間，如果一直未支付，會直接關閉訂單，而這個場景可以通過死信隊列的來解決

 

示例代碼

可以通過繼承BaseIntegrationEventHandler或者IIntegrationEventHandler，再通過QueueConsumer特性進行標識，具體代碼如下

  [QueueConsumer("UserLoginDateChangeHandler",QueueConsumerMode.Normal)]
    public  class UserLoginDateChangeHandler : BaseIntegrationEventHandler<UserEvent>
    {
        private readonly IUserService _userService;
        public UserLoginDateChangeHandler()
        {
            _userService = ServiceLocator.GetService<IUserService>("User");
        }
        public override async Task Handle(UserEvent @event)
        {
            Console.WriteLine($"消費1。");
            await _userService.Update(@event.UserId, new UserModel()
            {
                Age = @event.Age,
                Name = @event.Name,
                UserId = @event.UserId
            });
            Console.WriteLine($"消費1失敗。");
            throw new Exception();
        }

        public override Task Handled(EventContext context)
        {
            Console.WriteLine($"調用{context.Count}次。類型:{context.Type}");
            var model = context.Content as UserEvent;
            return Task.CompletedTask;
        }
    }

 可以通過以下選項去更改配置

"EventBus": {
    "EventBusConnection": "${EventBusConnection}|localhost",
    "EventBusUserName": "${EventBusUserName}|guest",//用戶名
    "EventBusPassword": "${EventBusPassword}|guest",//密碼
    "VirtualHost": "${VirtualHost}|/",
    "MessageTTL": "${MessageTTL}|30000",//消息過期時間，比如過期時間是30分鍾就是1800000
    "RetryCount": "${RetryCount}|1",//重試次數，這里設置的延遲隊列，只能設置為1
    "FailCount": "${FailCount}|3",//處理失敗流程重試次數，如果出現異常，會進行重試
    "prefetchCount": "${PrefetchCount}|0",//設置均勻分配消費者消息的個數
    "BrokerName": "${BrokerName}|surging_demo",//exchange 名稱
    "Port": "${EventBusPort}|5672"//端口
  }

生成綁定的隊列如下圖

通過rabbitmq管理工具，可以通過properties來查看重試次數count 等一些信息，如下圖所示

 

4、如何部署

surging 服務引擎構建鏡像部署在docker中，可以按照業務需求自定義化引擎，也可以從 docker hub中pull鏡像，可以按照如下流程從docker hub 拉取部署鏡像

如何pull鏡像

可以通過命令：

docker pull serviceengine/surging 

可以指定具體的tag來拉取，比如需要拉取v0.9.0.2，執行以下命令

docker pull serviceengine/surging:v0.9.0.2 

如何配置

1.鏡像可以用環境變量設置相關參數，而通過以下的默認配置文件知曉如何通過環境變量配置參數，配置的規則：${環境變量名}|默認值

{
  "Surging": {
    "Ip": "${Surging_Server_IP}|0.0.0.0",
    "WatchInterval": 30,
    "Port": "${Surging_Server_Port}|99",
    "MappingIp": "${Mapping_ip}",
    "MappingPort": "${Mapping_Port}",
    "Token": "true",
    "MaxConcurrentRequests": 20,
    "ExecutionTimeoutInMilliseconds": 30000,
    "Protocol": "${Protocol}|None", //Http、Tcp、None
    "RootPath": "${RootPath}|D:\\userapp",
    "Ports": {
      "HttpPort": "${HttpPort}|280",
      "WSPort": "${WSPort}|96"
    },
    "RequestCacheEnabled": false,
    "Packages": [
      {
        "TypeName": "EnginePartModule",
        "Using": "${UseEngineParts}|DotNettyModule;NLogModule;MessagePackModule;ConsulModule;HttpProtocolModule;WSProtocolModule;EventBusRabbitMQModule;"
      }
    ]
  }, //如果引用多個同類型的組件，需要配置Packages，如果是自定義按需引用，無需配置Packages
  "Consul": {
    "ConnectionString": "${Register_Conn}|127.0.0.1:8500", // "127.0.0.1:8500",
    "SessionTimeout": "${Register_SessionTimeout}|50",
    "RoutePath": "${Register_RoutePath}",
    "ReloadOnChange": true
  },
  "EventBus_Kafka": {
    "Servers": "${EventBusConnection}|localhost:9092",
    "MaxQueueBuffering": "${MaxQueueBuffering}|10",
    "MaxSocketBlocking": "${MaxSocketBlocking}|10",
    "EnableAutoCommit": "${EnableAutoCommit}|false",
    "LogConnectionClose": "${LogConnectionClose}|false",
    "OffsetReset": "${OffsetReset}|earliest",
    "GroupID": "${EventBusGroupID}|surgingdemo"
  },
  "EventBus": {
    "EventBusConnection": "${EventBusConnection}|localhost",
    "EventBusUserName": "${EventBusUserName}|guest",
    "EventBusPassword": "${EventBusPassword}|guest",
    "VirtualHost": "${VirtualHost}|/",
    "MessageTTL": "${MessageTTL}|30000",
    "RetryCount": "${RetryCount}|1",
    "FailCount": "${FailCount}|3",
    "BrokerName": "${BrokerName}|surging_demo",
    "Port": "${EventBusPort}|5672"
  },
  "Zookeeper": {
    "ConnectionString": "${Zookeeper_ConnectionString}|127.0.0.1:2181",
    "SessionTimeout": 50,
    "ReloadOnChange": true
  },
  "Logging": {
    "Debug": {
      "LogLevel": {
        "Default": "Information"
      }
    },
    "Console": {
      "IncludeScopes": true,
      "LogLevel": {
        "Default": "${LogLevel}|Debug"
      }
    },
    "LogLevel": {
      "Default": "${LogLevel}|Debug"
    }
  }
}

 

2.可以通過設置環境變量surgingpath和cachepath來指定自定義文件配置，比如，掛載/home/fanly 目錄，通過以下命令參數 -v /home/fanly:/home/fanly 來設定，再通過設置以下命令參數用來設定自定義文件配置

--env surgingpath=/home/fanly/configs/surgingSettings.json
--env cachepath=/home/fanly/configs/cacheSettings.json

 

如何啟動內置引擎組件

引擎可以加載多個同一類型的引擎組件，可以通過以下配置啟用哪一種引擎組件,如果是自定義的服務引擎，不需要配置以下配置，只需要按照需求引用組件

 "Packages": [
      {
        "TypeName": "EnginePartModule",
        "Using": "${UseEngineParts}|DotNettyModule;NLogModule;MessagePackModule;ConsulModule;HttpProtocolModule;WSProtocolModule;EventBusRabbitMQModule;"
      }
    ]

 

如何啟動引擎

比如 pull 的鏡像是serviceengine/surging:v0.9.0.2 ，可以按照以下命令進行啟動

docker run --name surging --env surgingpath=/home/fanly/configs/surgingSettings.json  --env cachepath=/home/fanly/configs/cacheSettings.json -v /home/fanly:/home/fanly  serviceengine/surging:v0.9.0.2 

 

 7.總結

如有問題請到這里提問 ，可以加入surging互相交流QQ群：542283494，引擎組件擴展溝通群：615562965