.net 開源配置組件 agileconfig的使用簡(jiǎn)介

介紹

在微服務(wù)大行其道的今天，系統(tǒng)會(huì)被拆分成多個(gè)模塊，作為單獨(dú)的服務(wù)運(yùn)行，同時(shí)為了集中化管理，我們還需要日志中心，配置中心等，很多開發(fā)人員可能更熟悉 apolloconfig，這個(gè)組件功能也很完善，dotnet的客戶端也主要是國(guó)人在維護(hù)和開發(fā)，之前公司就是選型的apollo，而且也在生產(chǎn)環(huán)境穩(wěn)定運(yùn)行，但是服務(wù)端是java的，而且部署服務(wù)端也有些麻煩。

今天主要介紹 agileconfig，這是一個(gè)基于.net core開發(fā)的輕量級(jí)配置中心，之前跟作者也有過溝通，也很熱情幫忙解決問題，它的特點(diǎn)有部署簡(jiǎn)單、配置簡(jiǎn)單、使用簡(jiǎn)單、學(xué)習(xí)簡(jiǎn)單等，同時(shí)也支持高可用（多節(jié)點(diǎn)）和docker部署，使用了freesql支持了多種多種數(shù)據(jù)庫(kù)存儲(chǔ)，sqlserver, mysql, sqlite, postgresql,oracle，freesql大法好！

架構(gòu)圖

部署服務(wù)端

首先，我們需要部署服務(wù)端，包含了控制臺(tái)ui和節(jié)點(diǎn)服務(wù)，節(jié)點(diǎn)服務(wù)使用了長(zhǎng)連接，配置變更后，會(huì)實(shí)時(shí)推送給客戶端，部署推薦使用docker部署，因?yàn)轫?xiàng)目是開源的，而且是.net core 編寫的，還有一種方式是可以到github下載源代碼，編譯后發(fā)布運(yùn)行。

配置信息是在數(shù)據(jù)庫(kù)記錄的，我們需要新建一個(gè)空的數(shù)據(jù)庫(kù)，然后運(yùn)行命令，程序會(huì)自動(dòng)幫我們初始化表結(jié)構(gòu)和數(shù)據(jù)。

docker run --name agile_config -e adminconsole=true -e db:provider=mysql -e db:conn="database=configdb;data source=host.docker.internal;user id=root;password=123456;" -p 5000:5000 -d kklldog/agile_config:latest

參數(shù)介紹：

• adminconsole 配置程序是否為管理控制臺(tái)，如果為true則啟用控制臺(tái)功能，訪問該實(shí)例會(huì)出現(xiàn)管理界面，多節(jié)點(diǎn)部署的話，只需要開啟一個(gè)控制臺(tái)即可。
• db:provider 配置程序的數(shù)據(jù)庫(kù)類型，可選 sqlserver，mysql，sqlite，npgsql，oracle。
• db:conn 配置數(shù)據(jù)庫(kù)連接串
  

訪問 http://localhost:5000/, 第一次啟動(dòng)，程序會(huì)要求我們初始化管理員密碼，設(shè)置完成以后，進(jìn)入到首頁(yè)，另外作者最近已經(jīng)用 react 重構(gòu)了ui，最近會(huì)更新，大家也可以嘗鮮。

然后還需要配置節(jié)點(diǎn)，多節(jié)點(diǎn)保證了高可用，那如果所有節(jié)點(diǎn)都掛了的話，程序會(huì)讀取本地的配置緩存，來保證正常的運(yùn)行，這點(diǎn)大家不用擔(dān)心, 我們需要在節(jié)點(diǎn)管理頁(yè)面手動(dòng)添加節(jié)點(diǎn)，這里我啟動(dòng)了一個(gè)節(jié)點(diǎn)，添加的地址為 http://192.168.100.103:5000 ，需要注意的是，這里在docker環(huán)境不能使用 localhost。

接下來需要配置應(yīng)用，點(diǎn)擊新增應(yīng)用，填寫應(yīng)用名稱，應(yīng)用id和應(yīng)用密鑰。

在客戶端程序使用

這里使用了asp net core web項(xiàng)目示例，首先需要安裝客戶端組件，執(zhí)行一下命令或者通過nuget安裝。

install-package agileconfig.client

然后修改appsetting.json 文件

{ 
"agileconfig": {
  "appid": "logservice",
  "secret": "123456",
  "nodes": "http://localhost:5000,http://localhost:5001"http://多個(gè)節(jié)點(diǎn)使用逗號(hào)分隔
}
}

然后修改 program.cs

public static ihostbuilder createhostbuilder(string[] args) =>
     host.createdefaultbuilder(args)
     .configureappconfiguration((context, config) =>
      {
         var configclient = new configclient();
         config.addagileconfig(configclient);
     })
      .configurewebhostdefaults(webbuilder =>
      {
          webbuilder.usestartup<startup>();
      });

準(zhǔn)備工作完成，接下來就要開始使用了，我們?cè)谂渲庙?xiàng)頁(yè)面上面添加配置，然后選中點(diǎn)擊上線。

然后可以在代碼中使用注入的 iconfiguration 獲取配置即可

[route("[controller]/[action]")]
  public class homecontroller : controllerbase
  {    
      private readonly iconfiguration _config;

      public homecontroller(iconfiguration config)
      {
          _config = config; 
      }

      [httpget]
      public iactionresult index()
      {
          var value = _config["agilekey"];

          return ok(new { value });
      }

然后啟動(dòng)程序，就可以盡情使用 agileconfig 了，在頁(yè)面上修改配置的話，我們的客戶端配置也是實(shí)時(shí)修改的。

在配置頁(yè)面上的配置都是字符串鍵值對(duì)的，那對(duì)于json字符串應(yīng)該怎么處理呢, 我們可以使用 tuhu.extensions.configuration.valuebinder.json 擴(kuò)展，通過nuget安裝即可，然后修改startup.cs 文件

public void configureservices(iservicecollection services)
{ 
    services.configurejsonvalue<logoptions>("", configuration.getsection("logoptions"));  
}

logoptions：

public class logoptions : ioptions<logoptions>
{
      public string level { get; set; }

      public int count { get; set; }

      public logoptions value => this;
}

這樣我們就可以在代碼中，使用注入的 ioptions<logoptions> 來獲取讀取配置。

總結(jié)

agileconfig 是使用 .net core 開發(fā)的配置組件，部署和使用起來都很簡(jiǎn)單，但是目前還有一些不足，比如多賬號(hào)權(quán)限管理，和多環(huán)境支持，一般是開發(fā)，灰度和正式，不過沒有關(guān)系，項(xiàng)目都是開源的，大家感興趣的一起建設(shè)，完善不足的功能，現(xiàn)在.net 社區(qū)是越來越好了，如果對(duì)大家有幫助的，可以支持一下！

https://github.com/kklldog/agileconfig

以上就是.net 開源配置組件 agileconfig的使用簡(jiǎn)介的詳細(xì)內(nèi)容，更多關(guān)于.net 開源配置組件 agileconfig的資料請(qǐng)關(guān)注碩編程其它相關(guān)文章！