.NET Core配置多环境

通过注入不同的环境变量来读取不同配置文件实现多环境配置。

.NET Core配置多环境

配置多环境是日常开发经常需要用到的操作,实现多环境配置后可以规避生产测试环境混合带来的麻烦和风险,减少项目风险,并且也可以通过多环境来保证生产环境上密钥的安全。

我之前在做iOS开发时,iOS的解决方法是通过多个Target配置不同的环境变量,并且配合来实现不同的环境启动时,读取不同的配置,在.NET Core中当然也会有类似的这种方式,并且它比iOS中更简单,只需要注入不同的环境变量即可,而iOS还需要建立多个Target才能实现注入不同的环境变量,.NET Core则可以直接在启动时注入不同的环境变量,根本无需再做其它操作。

方式一:预编译指令DEBUG

#if DEBUG
            //读取环境1配置文件
#else
            //读取环境2配置文件
#endif

如果你只有两套环境,这种方式也勉强够用,在日常开发中,我们基本上都是DeBug模式运行的,在生产环境发布的代码,也基本上都是编译的Release代码,所以使用预编译指令#if DEBUG即可以满足这种需求,而且这种操作方式非常简单,只需要准备两个不同的配置文件来给两个不同环境读取即可。

    /// <summary>
    /// 全局配置管理类(按照DEBUG/RELEASE区分环境)
    /// </summary>
    public static class MyConfiguration
    {
        public static IConfiguration Configuration { get; set; }
        static MyConfiguration()
        {
        #if DEBUG
            var envPath = "appsettings.Development.json";
        #else
            var envPath = "appsettings.json";
        #endif
            Configuration = new ConfigurationBuilder()
                .Add(new JsonConfigurationSource
                {
                    Path = envPath,
                    ReloadOnChange = true
                }).Build();
        }
    }

但是如果你想调试生产环境或者想实现两个以上的环境的话,那么就只能使用第二种方式了。

方式二:注入不同环境变量

首先准备好你不同环境的配置文件,例如:
----_20190214135843

然后选择启动项目Properties下的launchSettings.json文件,添加如下配置:

{
  "profiles": {
    "240": {
      "commandName": "IISExpress",
      "launchBrowser": true,
      "launchUrl": "",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Dev240"
      }
    },
    "241": {
      "commandName": "IISExpress",
      "launchBrowser": true,
      "launchUrl": "",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Dev241"
      }
    },"243": {
      "commandName": "IISExpress",
      "launchBrowser": true,
      "launchUrl": "",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Dev243"
      }
    },"Staging": {
      "commandName": "IISExpress",
      "launchBrowser": true,
      "launchUrl": "",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Staging"
      }
    }
  }
}

此时,启动选择已然变成这样:
----_20190214140432

当然,我们也可以直接在启动项目的Properties里面改,如下图:
----_20190214140748-1
当然环境变量配置好了之后,我们就需要来使用环境变量,新建一个配置的工具类文件:

    /// <summary>
    /// 全局配置管理类(适配多环境)
    /// </summary>
    public static class MyConfigurationHelper
    {
        public static IConfiguration Config { get; set; }
        static MyConfigurationHelper()
        {
            var env = MyServiceProvider.ServiceProvider.GetRequiredService<IHostingEnvironment>();
            Config = new ConfigurationBuilder()
                .SetBasePath(env.ContentRootPath)
                .AddJsonFile($"appsettings.{env.EnvironmentName}.json", true, true)
                .Build();
        }
       
    }

   public static class MyServiceProvider
    {
        public static IServiceProvider ServiceProvider { get; set; }
    }

这个文件中提供了一个读取配置IConfigurationMyConfigurationHelper类和一个提供IServiceProvider容器的MyServiceProviderIServiceProvider是.NET Core中的服务容器,他能够访问到程序注入的环境变量,然后进入Startup.cs中引用这个文件,并且在Configure方法中,将IApplicationBuilderApplicationServices传递进去。

   public void Configure(IApplicationBuilder app, IHostingEnvironment env)
   {
        //配置多环境
        MyServiceProvider.ServiceProvider = app.ApplicationServices;
   }

这时,我们回过去看MyConfigurationHelper类,它将会在下一次被使用时,从IServiceProvider中读取我们选择的启动环境对应的环境变量字符串Dev240Dev241Dev243Staging;从而实现读取不同的配置文件与IConfigurationConfig中,我们后继使用读取配置文件的操作时,都将使用MyConfigurationHelper.Config来进行读取。

发布时区分多环境

在Liunx上面,我们使用supervisor来守护我们的.NET Core应用程序,所以我们想要运行哪个环境,就可以在supervisor的项目配置中进行配置,修改/etc/supervisord.d/下的配置文件键入环境变量如下:

# /etc/supervisord.d/DotNetCoreTest.ini
[program:DotNetCoreTest]
directory=/xxx/DotNetCoreTest
command=dotnet DotNetCoreTest.dll
autostart=true
autorestart=true
user=root
numprocs=1
redirect_stderr=true
stdout_logfile=/xxx/logs/DotNetCoreTest.log
# 环境变量
environment=ASPNETCORE_ENVIRONMENT=Dev240

方式一在发布时只需要编译Release就能自动读取对应环境的配置文件,无需上面的操作。

如果有问题或者很喜欢,欢迎在下面留言评论,只需要GitHub账号即可。