你可能不知道的.Net Core Configuration

执行原理

　　1. 配置读取顺序：与代码先后顺序一致。

public Startup(IHostingEnvironment env)

{

var builder = new ConfigurationBuilder()

.SetBasePath(env.ContentRootPath)

.AddJsonFile("appsettings.json", false, true)

.AddJsonFile("cussettings.json", false, true);

Configuration = builder.Build();

}

以上代码会先读取appsettings.json，再读取cussettings.json，cussettings.json的内容会覆盖appsettings.json的内容。

　　2. 覆盖逻辑：原有的配置继承，相同的配置覆写，新增的配置添加。

　　appsettings.json：

    {      "settings": {     
   "name": "AppSetting",    
    "age": 20 } }

　　cussettings.json

    {      "settings": {       
 "name": "CusSetting",     
   "gender": "Male"} }

　　结果：

　　3. 可以设置配置文件不存在或失效时，程序不会被中止，该配置会被忽略。

　　如cussettings.json不存在或失效时：

环境变量

　　1. appsettings.{env.EnvironmentName}.json

　　可以根据当前的环境变量设置读取对应的配置，来覆盖之前的配置，有点像Asp.Net的Web Transform，其中环境变量的key为：ASPNETCORE_ENVIRONMENT。

　　可以在四个地方设置该环境变量：

　　a) Visual Studio 2017中的launchSettings.json

　　b) 操作系统的环境变量

　　Windows：

　　Linux：

　　c) Dockerfile

　　FROM microsoft/aspnetcore:1.1
　　COPY . /app
　　WORKDIR /app
　　EXPOSE 5000/tcp
　　ENV ASPNETCORE_URLS http://*:5000/
　　ENV ASPNETCORE_ENVIRONMENT Production
　　ENTRYPOINT ["dotnet", "EnvironmentVariable.dll"]

　　d) Docker启动指令

　　docker run --name {name} -e ASPNETCORE_ENVIRONMENT=Production ...

　　如：

　　2. AddEnvironmentVariables()的作用

    var builder = new ConfigurationBuilder().SetBasePath(env.ContentRootPath).AddJsonFile("appsettings.json", false, true).AddJsonFile($"appsettings.{env.EnvironmentName}.json", true).AddEnvironmentVariables();//作用？Configuration = builder.Build();

　　a) 读取系统的环境变量信息，这个应该大部分人都知道。

　　b) 覆盖之前的配置信息。

　　appsettings.json：

{ 
 "settings": {  
  "name": "AppSetting"}
}

　　通过环境变量来覆盖settings:name：

　　说明：这里是用控制台运行，因为操作系统的环境变量要对IIS Express生效，要重启vs2017，我懒！

　　另外环境变量使用两下划线（__）作为层次的分隔符，具体可参考EnvironmentVariablesConfigurationProvider的源码。

Spring Cloud Config Server

　　Config Server是Spring Cloud 配置管理的重要中间件，接下来，我们看一下.Net Core如何跟Config Server进行交互。

　　1. 准备配置文件，这里使用Git作为配置文件的Source，地址：https://github.com/ErikXu/.NetCore-Configuration

　　2. 获取安装包，这里使用Docker启动，因此，是拉取官方镜像：docker pull hyness/spring-cloud-config-server

　　3. 准备启动资源文件application.yml

info:

component: config service

server:

port: 8888

spring:

application:

name: git-config

profiles:

active: dev

cloud:

config:

server:

git:

uri: https://github.com/ErikXu/.NetCore-Configuration

searchPaths: Configs

　　4. 执行指令启动Config Server

　　docker run --name configsvr -it -d -p 8888:8888 -v /root/config-server/application.yml:/config/application.yml hyness/spring-cloud-config-server

　　5. 引入Nuget包

　　Install-Package Steeltoe.Extensions.Configuration.ConfigServer -Version 1.1.1

　　6. 准备appsetting.json

{

"spring": {

"application": {

"name": "foo"

"cloud": {

"config": {

"uri": "http://192.168.52.142:8888",

"validate_certificates": false,

"env": "dev"

}

"settings": {

"name": "AppSetting"//会被Config Server的内容覆盖

}

7. 引入Config Server

　　结果：

挂卷Volume

　　挂卷是docker的一种机制，可以把特定的目录或者文件挂载到docker容器的指定位置。配合.Net Core Configuration的机制，可以在appsetting.json中记录开发环境的配置，然后再指定一个待挂载的文件用于记录不同环境的配置，从而覆盖开发环境的配置，达到多环境适配的能力。

　　1. appsetting.json

{

"settings": {

"name": "AppSetting"

}

　　2. 指定一个待挂载的目录，但是在开发环境不存在此文件。

public Startup(IHostingEnvironment env)

{

var builder = new ConfigurationBuilder()

.SetBasePath(env.ContentRootPath)

.AddJsonFile("appsettings.json", false, true)

.AddJsonFile($"appsettings.{env.EnvironmentName}.json", true)

.AddEnvironmentVariables()

.AddJsonFile("/configs/volume.json", true, true); //待挂载

Configuration = builder.Build();

}

3. 开发环境

　　4. docker启动指令

　　docker run --name {name} -v {source}:{target} ...

　　注：如果有权限问题，需要先执行setenforce 0

　　5. 效果

　　挂卷感觉跟appsettings.{env.EnvironmentName}.json很像，既然如此，为什么还要有挂卷呢？那是因为appsettings.{env.EnvironmentName}.json是.net core的机制，其它语言不一定会有，或者是另外的机制，docker的挂卷是服务各种语言的。.Net Core是很优秀的语言，它接收了很多业界的需求，也响应了docker挂卷的机制，在这一点上，.net的能力就相对较弱了。