AgileConfig怎么在.NET中使用

今天就跟大家聊聊有关 AgileConfig怎么在.NET中使用，可能很多人都不太了解，为了让大家更加了解，小编给大家总结了以下内容，希望大家根据这篇文章可以有所收获。

架构图

部署服务端

首先，我们需要部署服务端，包含了控制台UI和节点服务，节点服务使用了长连接，配置变更后，会实时推送给客户端，部署推荐使用docker部署，因为项目是开源的，而且是.net core 编写的，还有一种方式是可以到github下载源代码，编译后发布运行。

配置信息是在数据库记录的，我们需要新建一个空的数据库，然后运行命令，程序会自动帮我们初始化表结构和数据。

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

参数介绍：

• adminConsole 配置程序是否为管理控制台，如果为true则启用控制台功能，访问该实例会出现管理界面，多节点部署的话，只需要开启一个控制台即可。

• db:provider 配置程序的数据库类型，可选 sqlserver，mysql，sqlite，npgsql，oracle。

• db:conn 配置数据库连接串
  

访问 http://localhost:5000/, 第一次启动，程序会要求我们初始化管理员密码，设置完成以后，进入到首页，另外作者最近已经用 React 重构了UI，最近会更新，大家也可以尝鲜。

然后还需要配置节点，多节点保证了高可用，那如果所有节点都挂了的话，程序会读取本地的配置缓存，来保证正常的运行，这点大家不用担心, 我们需要在节点管理页面手动添加节点，这里我启动了一个节点，添加的地址为 http://192.168.100.103:5000 ，需要注意的是，这里在docker环境不能使用 localhost。

接下来需要配置应用，点击新增应用，填写应用名称，应用Id和应用密钥。

在客户端程序使用

这里使用了asp net core web项目示例，首先需要安装客户端组件，执行一下命令或者通过Nuget安装。

Install-Package AgileConfig.Client

然后修改appsetting.json 文件

{ 
  "AgileConfig": {
    "appId": "LogService",
    "secret": "123456",
    "nodes": "http://localhost:5000,http://localhost:5001"//多个节点使用逗号分隔
  }
}

然后修改 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>();
        });

准备工作完成，接下来就要开始使用了，我们在配置项页面上面添加配置，然后选中点击上线。

然后可以在代码中使用注入的 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 });
        }

然后启动程序，就可以尽情使用 AgileConfig 了，在页面上修改配置的话，我们的客户端配置也是实时修改的。

在配置页面上的配置都是字符串键值对的，那对于Json字符串应该怎么处理呢, 我们可以使用 Tuhu.Extensions.Configuration.ValueBinder.Json 扩展，通过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;
}

看完上述内容，你们对 AgileConfig怎么在.NET中使用有进一步的了解吗？如果还想了解更多知识或者相关内容，请关注亿速云行业资讯频道，感谢大家的支持。