Динамічне оновлення .net core config з конфігурації додатка Azure


9

Що я намагаюся зробити: я намагаюся налаштувати конфігурацію додатка Azure за допомогою веб-додатка з ядром .net 2.1 mvc за допомогою дозорного ключа в конфігурації додатка Azure, щоб мати змогу змінювати клавіші в лазурі, і жоден з клавіш буде оновлюватися в моїх додатках, поки значення дозорного не зміниться. Теоретично це повинно дозволяти мені безпечно налаштувати конфігурації заміни.

Яка моя проблема полягає в тому, що коли я це роблю, немає способу WatchAndReloadAll () для перегляду дозорного на IWebHostBuilder, а альтернативні методи Refresh () не здають оновити конфігурацію в їх стані.

Довідкова інформація та те, що я спробував: минулого тижня я відвідував VS Live - Сан-Дієго, і переглядав демонстрацію програми конфігурації додатків Azure. У мене виникли деякі проблеми при спробі отримати програму для оновлення значень конфігурації під час імпотенції, тому я також посилався на цю демонстрацію, описуючи, як це зробити. Відповідний розділ знаходиться приблизно через 10 хвилин. Однак, схоже, цей метод не доступний у IWebHostBuilder.

Документація, на яку я посилаюся: В офіційній документації немає посилання на цей метод, див. Ядро doc quickstart .net ядро та динамічна конфігурація doc. Core core

Моє середовище: Використання точкового ядра 2.1 запускається з Visual Studio Enterprise 2019, з останнім пакетом попереднього перегляду для Microsoft.Azure.AppConfiguration.AspNetCore 2.0.0-preview-010060003-1250

Мій код: У демонстраційній версії вони створили IWebHostBuilder за допомогою методу CreateWebHostBuilder (string [] args) таким чином:

public static IWebHostBuilder CreateWebHostBuilder(string[] args)
{
    return WebHost.CreateDefaultBuilder(args)
    .ConfigureAppConfiguration((hostingContext, config) =>
    {
        var settings = config.Build();
        config.AddAzureAppConfiguration(options =>
        {
            options.Connect(settings["ConnectionStrings:AzureConfiguration"])
            .Use(keyFilter: "TestApp:*")
            .WatchAndReloadAll(key: "TestApp:Sentinel", pollInterval: TimeSpan.FromSeconds(5));
        }); 
    })
    .UseStartup<Startup>();
}

Я також спробував це таким чином, використовуючи поточну документацію:

public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
    WebHost.CreateDefaultBuilder(args)
    .ConfigureAppConfiguration((hostingContext, config) =>
    {
        var settings = config.Build();

        config.AddAzureAppConfiguration(options =>
        {
            // fetch connection string from local config. Could use KeyVault, or Secrets as well.
            options.Connect(settings["ConnectionStrings:AzureConfiguration"])
            // filter configs so we are only searching against configs that meet this pattern
            .Use(keyFilter: "WebApp:*")
            .ConfigureRefresh(refreshOptions =>
            { 
                // In theory, when this value changes, on the next refresh operation, the config will update all modified configs since it was last refreshed.
                refreshOptions.Register("WebApp:Sentinel", true);
                refreshOptions.Register("WebApp:Settings:BackgroundColor", false);
                refreshOptions.Register("WebApp:Settings:FontColor", false);
                refreshOptions.Register("WebApp:Settings:FontSize", false);
                refreshOptions.Register("WebApp:Settings:Message", false);
            });
        });
    })
    .UseStartup<Startup>();

Потім у моєму стартовому класі:

public Startup(IConfiguration configuration)
{
    Configuration = configuration;
}

public IConfiguration Configuration { get; }

// This method gets called by the runtime. Use this method to add services to the container.
public void ConfigureServices(IServiceCollection services)
{
    services.Configure<Settings>(Configuration.GetSection("WebApp:Settings"));
    services.Configure<CookiePolicyOptions>(options =>
    {
        // This lambda determines whether user consent for non-essential cookies is needed for a given request.
        options.CheckConsentNeeded = context => true;
        options.MinimumSameSitePolicy = SameSiteMode.None;
    });

    services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_1);
}

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
    }
    else
    {
        app.UseExceptionHandler("/Home/Error");
        app.UseHsts();
    }

    app.UseAzureAppConfiguration();
    app.UseHttpsRedirection();
    app.UseStaticFiles();
    app.UseCookiePolicy();

    app.UseMvc(routes =>
    {
        routes.MapRoute(
            name: "default",
            template: "{controller=Home}/{action=Index}/{id?}");
    });
}

і, нарешті, моя конфігураційна модель налаштувань:

public class Settings
{
    public string BackgroundColor { get; set; }
    public long FontSize { get; set; }
    public string FontColor { get; set; }
    public string Message { get; set; }
}

Тепер у своєму контролері я витягаю ці налаштування і кидаю їх у сумку для перегляду, яка відображатиметься на поданні.

public class HomeController : Controller
{
    private readonly Settings _Settings;

    public HomeController(IOptionsSnapshot<Settings> settings)
    {
        _Settings = settings.Value;
    }

    public IActionResult Index()
    {
        ViewData["BackgroundColor"] = _Settings.BackgroundColor;
        ViewData["FontSize"] = _Settings.FontSize;
        ViewData["FontColor"] = _Settings.FontColor;
        ViewData["Message"] = _Settings.Message;

        return View();
    }
}

Простий вид для відображення змін:

<!DOCTYPE html>
<html lang="en">
<style>
    body {
        background-color: @ViewData["BackgroundColor"]
    }
    h1 {
        color: @ViewData["FontColor"];
        font-size: @ViewData["FontSize"];
    }
</style>
<head>
    <title>Index View</title>
</head>
<body>
    <h1>@ViewData["Message"]</h1>
</body>
</html>

Я можу змусити його вперше тягнути конфігурацію, однак функція оновлення, здається, не працює.

В останньому прикладі я очікував, що конфігурація оновлюватиметься, коли дозорному встановлено будь-яке нове значення або, принаймні, оновить значення через 30 секунд після його зміни. Тривалість очікування не оновлює значення, а лише повне вимкнення та перезапуск програми завантажує нову конфігурацію.

Оновлення: додавання app.UseAzureAppConfiguration (); у способі налаштування під час запуску та встановленні явного тайм-ауту в кеші для конфігурації фіксується метод оновлення для оновлення через фіксований проміжок часу, але функція дозорного все ще не працює, як і прапор updateAll за методом оновлення.


Чи можете ви показати мені, як і де ви отримуєте доступ до конфігурації? Я наслідував вашу ситуацію в одному з моїх власних проектів, і це прекрасно працює
Пітер Бонс

Я очікував, що конфігурація буде прив’язана десь у вашому ConfigureServicesметоді на startuop.cs, наприклад services.Configure<LogSettings>(configuration.GetSection("LogSettings"));
Пітер Бонс

@peterBons ваше посилання переводить мене на 404.
Нік Гася Робіч

@PeterBons Я оновив свою публікацію, щоб включити запитувану інформацію щодо введення / зв'язування конфігурації. Я не думав, що це було сприятливо на той час, тому що це спрацювало.
Нік Гася Робіч

1
Це було все. Ласкаво просимо.
Пітер Бонс

Відповіді:


6

Ок, після тестування та проб і помилок, я працюю.

Моя проблема була відсутнім сервісом для azure методу налаштування. Тут є якась цікава поведінка, оскільки вона все одно знизить налаштування, вона просто не буде оновлена, якщо цього немає. Отже, як тільки це було введено, і при правильному дозволі, налаштованому на документацію, він працює з прапором updateAll. Однак наразі це не зафіксовано.

Ось рішення:

У Program.cs:

using Microsoft.AspNetCore;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Configuration.AzureAppConfiguration;

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

        public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
            WebHost.CreateDefaultBuilder(args)
            .ConfigureAppConfiguration((hostingContext, config) =>
            {
                var settings = config.Build();

                config.AddAzureAppConfiguration(options =>
                {
                    // fetch connection string from local config. Could use KeyVault, or Secrets as well.
                    options.Connect(settings["ConnectionStrings:AzureConfiguration"])
                    // filter configs so we are only searching against configs that meet this pattern
                    .Use(keyFilter: "WebApp:*")
                    .ConfigureRefresh(refreshOptions =>
                    { 
                        // When this value changes, on the next refresh operation, the config will update all modified configs since it was last refreshed.
                        refreshOptions.Register("WebApp:Sentinel", true);
                        // Set a timeout for the cache so that it will poll the azure config every X timespan.
                        refreshOptions.SetCacheExpiration(cacheExpirationTime: new System.TimeSpan(0, 0, 0, 15, 0));
                    });
                });
            })
            .UseStartup<Startup>();
    }
}

Потім у Startup.cs:

using ASPNetCoreApp.Models;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;

namespace ASPNetCoreApp
{
    public class Startup
    {
        public Startup(IConfiguration configuration)
        {
            Configuration = configuration;
        }

        public IConfiguration Configuration { get; }

        // This method gets called by the runtime. Use this method to add services to the container.
        public void ConfigureServices(IServiceCollection services)
        {
            // bind the config to our DI container for the settings we are pulling down from azure.
            services.Configure<Settings>(Configuration.GetSection("WebApp:Settings"));
            services.Configure<CookiePolicyOptions>(options =>
            {
                // This lambda determines whether user consent for non-essential cookies is needed for a given request.
                options.CheckConsentNeeded = context => true;
                options.MinimumSameSitePolicy = SameSiteMode.None;
            });

            services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_1);
        }

        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
        public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }
            else
            {
                app.UseExceptionHandler("/Home/Error");
                app.UseHsts();
            }
            // Set the Azure middleware to handle configuration
            // It will pull the config down without this, but will not refresh.
            app.UseAzureAppConfiguration();
            app.UseHttpsRedirection();
            app.UseStaticFiles();
            app.UseCookiePolicy();

            app.UseMvc(routes =>
            {
                routes.MapRoute(
                    name: "default",
                    template: "{controller=Home}/{action=Index}/{id?}");
            });
        }
    }
}

Модель налаштувань я пов'язую отримані дані з лазурного покриття до:

namespace ASPNetCoreApp.Models
{
    public class Settings
    {
        public string BackgroundColor { get; set; }
        public long FontSize { get; set; }
        public string FontColor { get; set; }
        public string Message { get; set; }
    }
}

Загальний домашній контролер із налаштованим конфігурацією ViewBag для переходу до нашого перегляду:

using ASPNetCoreApp.Models;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Options;
using System.Diagnostics;

namespace ASPNetCoreApp.Controllers
{
    public class HomeController : Controller
    {
        private readonly Settings _Settings;

        public HomeController(IOptionsSnapshot<Settings> settings)
        {
            _Settings = settings.Value;
        }
        public IActionResult Index()
        {
            ViewData["BackgroundColor"] = _Settings.BackgroundColor;
            ViewData["FontSize"] = _Settings.FontSize;
            ViewData["FontColor"] = _Settings.FontColor;
            ViewData["Message"] = _Settings.Message;

            return View();
        }

        public IActionResult About()
        {
            ViewData["Message"] = "Your application description page.";

            return View();
        }

        public IActionResult Contact()
        {
            ViewData["Message"] = "Your contact page.";

            return View();
        }

        public IActionResult Privacy()
        {
            return View();
        }

        [ResponseCache(Duration = 0, Location = ResponseCacheLocation.None, NoStore = true)]
        public IActionResult Error()
        {
            return View(new ErrorViewModel { RequestId = Activity.Current?.Id ?? HttpContext.TraceIdentifier });
        }
    }
}

Наш погляд:

<!DOCTYPE html>
<html lang="en">
<style>
    body {
        background-color: @ViewData["BackgroundColor"]
    }
    h1 {
        color: @ViewData["FontColor"];
        font-size: @ViewData["FontSize"];
    }
</style>
<head>
    <title>Index View</title>
</head>
<body>
    <h1>@ViewData["Message"]</h1>
</body>
</html>

Сподіваюся, це допоможе комусь іншому!

Використовуючи наш веб-сайт, ви визнаєте, що прочитали та зрозуміли наші Політику щодо файлів cookie та Політику конфіденційності.
Licensed under cc by-sa 3.0 with attribution required.