如何使用AWS和Azure的配置存储服务保存读取配置

原文：Want to yank configuration values from your .NET Core apps?
作者：pauljwheeler
译文：https://www.cnblogs.com/lwqlun/p/10508748.html
译者：Lamond Lu
示例源代码：https://github.com/lamondlu/LoadConfigurationFromCloud

背景

我们创建的大部分.NET Core应用都会使用配置文件。如果你了解过12 Factor理论(https://12factor.net/zh_cn/), 你可能会希望将配置文件与代码隔离。这就意味你不能将应用配置存在appsetting.json文件中或者硬编码在程序中。

这时候我们可以使用环境变量来完成以上的需求，但这并不是很好的选择，这种方案有2个缺点

没有版本控制
没有访问权限控制

今天我就给大家介绍一下AWS和Azure中提供的配置服务。

AWS

AWS的AWS Systems Manager服务中，提供了一个名为Parameter Store的子服务。此服务可以用来维护项目中使用的配置数据。据我所知，它可以免费使用。

使用配置服务添加配置

首先，我们访问了AWS控制台，找到了Systems Manager服务，并从左侧菜单中选择了Parameter Store。从这里，我们可以编辑或删除现有参数，并创建新参数。

每个参数都有一个名称和值。对于名称，我们使用“/”来定义层次结构(例如：/lamond/project1/config1)。参数类型可以是字符串，字符串列表或加密字符串。

整个UI的功能非常智能，这里当输入参数名称的时候，它会自动匹配已有的参数名称

为了演示效果，这里我添加了2个配置，一个名为/lamond/project1/config1，值是"Hello world", 另外一个名为/lamond/project1/config2, 值为"We love Cloud".

好的，以上我们就完成在AWS控制台中的配置，下面让我们看一下如何在一个.NET Core Web应用中读取这个配置。

如何从代码中读取配置

这里首先我们创建创建一个ASP.NET Core MVC项目，并添加程序集

Amazon.Extensions.Configuration.SystemsManager

然后，我们创建一个简单的Setting类, 用来存储从AWS Parameter Store中拉取的配置值

    public class Settings
    {
       public string Config1 { get; set; }
       public string Config2 { get; set; }
    }

然后，我们需要在appsettings.json文件中配置AWS配置服务的region和profile.

    {
      "Logging": {
        "LogLevel": {
          "Default": "Warning"
        }
      },
      "AllowedHosts": "*",
      "AWS": {
        "Profile": "default",
        "Region": "us-west-2"
      }
    }

下一步，我们需要修改Program.cs文件，启用从AWS Systems Manager中读取配置, 这里我是从/lamond中读取配置

    public class Program
    {
      public static void Main(string[] args)
      {
         CreateWebHostBuilder(args).Build().Run();
      }

      public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
         WebHost.CreateDefaultBuilder(args)
           .ConfigureAppConfiguration(builder =>
           {
              builder.AddSystemsManager("/lamond");
           })
           .UseStartup<Startup>();
    }

接下来，和一般的强类型配置绑定一样，我们还需要在Startup.cs的ConfigureService方法中，绑定配置。

    public void ConfigureServices(IServiceCollection services)
    {
        services.Configure<Settings>(Configuration.GetSection("properties"));

        services.Configure<CookiePolicyOptions>(options =>
        {
           options.CheckConsentNeeded = context => true;
           options.MinimumSameSitePolicy = SameSiteMode.None;
        });
    }

最后，我们就可以在控制器中注入强配型配置, 并读取配置了

    private readonly Settings _settings;

    public HomeController(IOptions<Settings> settings)
    {
        _settings = settings.Value;
    }

    public IActionResult Index()
    {
        ViewData["configval"] = _settings.Config1;
        ViewData["configval2"] = _settings.Config2;

        return View();
    }

最终效果

注意：这里启动项目的时候如果出现未授权错误，你需要安装AWS CLI配置本地使用Access Key ID和Access Secret，或者只用环境变量来设置Access Key ID和Access Secret。

其他优点

AWS的Parameter Store除了免费之外，还提供了一个历史记录功能。你可以每个版本配置的更改内容和操作人。

另外AWS团队还编写一个针对.NET Core的扩展，使用这个扩展，当你的配置发生变化的时候，.NET Core应用可以自动刷新配置信息。

Azure

微软近期刚刚推出了Azure App Configuration服务的预览版。这个服务可以帮助你集中你的配置。这是一个全新的服务，下面让我们看一看如何使用它。

使用配置服务添加配置

首先，我们可以通过Azure管理站点，搜索configuration服务，图中的App Configuration就是我们所需的服务。

下一步，我们来创建一个配置组，这里我将配置组命名为lamond-config

添加完成之后，我们就可以在Key-Value Explorer面板中为当前配置组添加配置信息了

和前面AWS的例子一样，我们添加2个配置值。

这样配置工作就完成了，接下来我们编写代码使用.NET Core读取App Configuration服务中的配置。

如何从代码中读取配置

这里我重新创建了一个新的ASP.NET Core API站点，并添加程序集

Microsoft.Extensions.Configuration.AzureAppConfiguration

项目创建成功后，我们首先添加一个Settings类

public class Settings
{
    public string Config1 { get; set; }
    public string Config2 { get; set; }
}

下一步，我们需要更新Program.cs文件，启动Azure App Configuration

    public class Program
    {
        public static void Main(string[] args)
        {
            CreateWebHostBuilder(args).Build().Run();
        }

        public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
            WebHost.CreateDefaultBuilder(args)
                .ConfigureAppConfiguration((hostingContext, config) =>
                {
                    var settings = config.Build();
                    config.AddAzureAppConfiguration("[xxx]");
                })
                .UseStartup<Startup>();
    }

这里我们需要将Azure App Configuration的连接字符串放在这里。

第三步，我们依然要在ConfigureServices方法中进行强类型配置绑定

    public void ConfigureServices(IServiceCollection services)
    {
        services.Configure<Settings>(Configuration.GetSection("lamond-config"));
        services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2);
    }

最后，我们就可以在API中读取强类型配置了

    [Route("api/[controller]")]
    [ApiController]
    public class ValuesController : ControllerBase
    {
        private Settings _settings;

        public ValuesController(IOptions<Settings> settingsAccessor)
        {
            _settings = settingsAccessor.Value;
        }

        // GET api/values
        [HttpGet]
        public ActionResult<IEnumerable<string>> Get()
        {
            return new List<string> { _settings.Config1, _settings.Config2 };
        }
    }