Rychlý start: Vytvoření ASP.NET Core aplikace pomocí Azure App Configuration

V tomto rychlém startu použijete Azure App Configuration centralizaci úložiště a správy nastavení aplikace pro ASP.NET Core aplikace. ASP.NET Core sestaví jeden objekt konfigurace založený na klíč-hodnota pomocí nastavení z jednoho nebo více zdrojů dat určených aplikací. Tyto zdroje dat se označuje jako poskytovatelé konfigurace. Vzhledem App Configuration je klient .NET Core implementován jako poskytovatel konfigurace, služba se jeví jako jiný zdroj dat.

Požadavky

• Předplatné Azure – vytvořte si ho zdarma.
• Sada .NET Core SDK

Vytvoření App Configuration úložiště

1. Pokud chcete vytvořit nové úložiště konfigurace aplikace, přihlaste se k Azure Portal. V levém horním rohu domovské stránky vyberte vytvořit prostředek. Do pole Hledat na Marketplace zadejte Konfigurace aplikace a vyberte ENTER.

   

2. Ve výsledcích hledání vyberte Konfigurace aplikace a pak vyberte vytvořit.

   

3. V podokně vytvořit konfiguraci aplikace zadejte následující nastavení:

   Nastavení	Navrhovaná hodnota	Popis
   Předplatné	Vaše předplatné	Vyberte předplatné Azure, které chcete použít k testování konfigurace aplikace. Pokud má váš účet jenom jedno předplatné, vybere se automaticky a seznam předplatných se nezobrazí.
   Skupina prostředků	AppConfigTestResources	Vyberte nebo vytvořte skupinu prostředků pro prostředek úložiště konfigurace aplikace. Tato skupina je užitečná k organizování více prostředků, které můžete chtít odstranit současně odstraněním skupiny prostředků. Další informace najdete v tématu použití skupin prostředků ke správě prostředků Azure.
   Název prostředku	Globálně jedinečný název	Zadejte jedinečný název prostředku, který se má použít pro prostředek úložiště konfigurace aplikace. Název musí být řetězec o 5 až 50 znaků a obsahovat pouze čísla, písmena a - znak. Název nesmí začínat ani končit - znakem.
   Umístění	USA – střed	Umístění použijte k určení geografického umístění, ve kterém je úložiště konfigurace aplikace hostované. Nejlepšího výkonu dosáhnete vytvořením prostředku ve stejné oblasti jako jiné součásti aplikace.
   Cenová úroveň	Free	Vyberte požadovanou cenovou úroveň. Další informace najdete na stránce s cenami konfigurace aplikací.

4. Vyberte zkontrolovat + vytvořit a ověřte nastavení.

5. Vyberte Vytvořit. Nasazení může trvat několik minut.

6. Po dokončení nasazení přejděte do prostředku konfigurace aplikace. Vyberte Nastavení > Přístupové klíče. Poznamenejte si primární připojovací řetězec klíče jen pro čtení. Pomocí tohoto připojovacího řetězce později nakonfigurujete aplikaci tak, aby komunikovala s úložištěm konfigurace aplikace, které jste vytvořili.

7. Výběrem možnosti Operations Configuration Explorer Create Key-value (Vytvořit > > > klíč-hodnotu) přidejte následující páry klíč-hodnota:

   Klíč	Hodnota
   TestApp:Settings:BackgroundColor	#FFF
   TestApp:Settings:FontColor	#000
   TestApp:Settings:FontSize	24
   TestApp:Settings:Message	Data z Azure App Configuration

   Pole Label (Popisek) a Content type (Typ obsahu) nechte v seznamu prázdné. Vyberte Použít.

Vytvoření webové aplikace ASP.NET Core

Pomocí rozhraní příkazového řádku .NET Core vytvořte nový projekt ASP.NET Core MVC. Tyto Azure Cloud Shell vám poskytne následující nástroj. Jsou k dispozici také napříč platformami Windows, macOS a Linux.

Spuštěním následujícího příkazu vytvořte nový ASP.NET Core MVC v nové složce TestAppConfig:

dotnet new mvc --no-https --output TestAppConfig

Přidat správce tajných klíčů

Nástroj s názvem správce tajných dat uchovává citlivá data pro vývojovou práci mimo strom projektu. Tento přístup pomáhá zabránit náhodnému sdílení tajných kódů aplikace ve zdrojovém kódu. Provedením následujících kroků povolíte použití Správce tajných klíčů v projektu ASP.NET Core:

dotnet user-secrets init

<Project Sdk="Microsoft.NET.Sdk.Web">
    
    <PropertyGroup>
        <TargetFramework>net5.0</TargetFramework>
        <UserSecretsId>79a3edd0-2092-40a2-a04d-dcb46d5ca9ed</UserSecretsId>
    </PropertyGroup>

</Project>

dotnet user-secrets init

<Project Sdk="Microsoft.NET.Sdk.Web">
    
    <PropertyGroup>
        <TargetFramework>netcoreapp3.1</TargetFramework>
        <UserSecretsId>79a3edd0-2092-40a2-a04d-dcb46d5ca9ed</UserSecretsId>
    </PropertyGroup>

</Project>

Připojení do App Configuration úložiště

1. Spuštěním následujícího příkazu přidejte odkaz na balíček Microsoft.Azure.AppConfiguration.AspNetCore NuGet balíčku:

   dotnet add package Microsoft.Azure.AppConfiguration.AspNetCore
   

2. Spusťte následující příkaz ve stejném adresáři jako soubor .csproj. Příkaz používá Secret Manager k uložení tajného klíče s názvem , který ukládá připojovací ConnectionStrings:AppConfig řetězec pro App Configuration úložiště. Zástupný text <your_connection_string> nahraďte připojovacím App Configuration vašeho úložiště úložiště. Připojovací řetězec najdete v části Přístupové klíče v Azure Portal.

   dotnet user-secrets set ConnectionStrings:AppConfig "<your_connection_string>"
   

   Důležité

   Některá prostředí připojovací řetězec zkrátí, pokud není uzavřený v uvozovkách. Ujistěte se, že výstup dotnet user-secrets list příkazu zobrazuje celý připojovací řetězec. Pokud tomu tak není, spusťte příkaz znovu a připojovací řetězec uzavřete do uvozovek.

   Secret Manager slouží pouze k místnímu testování webové aplikace. Když je aplikace nasazená do Azure App Service, použijte k uložení připojovacího řetězce nastavení aplikace Připojovací řetězce v App Service Secret Manageru.

   K tomuto tajnému klíči můžete přistupovat pomocí konfiguračního rozhraní API .NET Core. Dvojtečka ( : ) funguje v názvu konfigurace s konfiguračním rozhraním API na všech podporovaných platformách. Další informace najdete v tématu Konfigurační klíčea hodnoty .

3. V souboru Program.cs přidejte odkaz na obor názvů rozhraní .NET Core Configuration API:

   using Microsoft.Extensions.Configuration;
   

4. Aktualizujte CreateWebHostBuilder metodu tak, aby App Configuration, zavoláte AddAzureAppConfiguration metodu .

   Důležité

   CreateHostBuilder nahrazuje v CreateWebHostBuilder .NET Core 3.x. Vyberte správnou syntaxi na základě vašeho prostředí.

   • .NET 5.x
   • .NET Core 3.x
   • .NET Core 2.x

   public static IHostBuilder CreateHostBuilder(string[] args) =>
       Host.CreateDefaultBuilder(args)
           .ConfigureWebHostDefaults(webBuilder =>
               webBuilder.ConfigureAppConfiguration(config =>
               {
                   var settings = config.Build();
                   var connection = settings.GetConnectionString("AppConfig");
                   config.AddAzureAppConfiguration(connection);
               }).UseStartup<Startup>());
   

   Po předchozí změně se zprostředkovatel konfigurace pro App Configuration zaregistroval v rozhraní .NET Core Configuration API.

Čtení z App Configuration úložiště

Provedením následujících kroků načtěte a zobrazte hodnoty uložené v App Configuration úložiště. Rozhraní .NET Core Configuration API se použije pro přístup k obchodu. syntaxe Razor se použije k zobrazení hodnot klíčů.

Otevřete <app root> /Views/Home/Index.cshtml a nahraďte jeho obsah následujícím kódem:

@using Microsoft.Extensions.Configuration
@inject IConfiguration Configuration

<style>
    body {
        background-color: @Configuration["TestApp:Settings:BackgroundColor"]
    }
    h1 {
        color: @Configuration["TestApp:Settings:FontColor"];
        font-size: @Configuration["TestApp:Settings:FontSize"]px;
    }
</style>

<h1>@Configuration["TestApp:Settings:Message"]</h1>

V předchozím kódu se App Configuration klíče úložiště úložiště používají takto:

• Hodnota TestApp:Settings:BackgroundColor klíče se přiřadí k vlastnosti background-color CSS.
• Hodnota TestApp:Settings:FontColor klíče se přiřadí k vlastnosti color CSS.
• Hodnota TestApp:Settings:FontSize klíče se přiřadí k vlastnosti font-size CSS.
• Hodnota TestApp:Settings:Message klíče se zobrazí jako nadpis.

Místní sestavení a spuštění aplikace

1. Pokud chcete aplikaci sestavit pomocí .NET Core CLI, přejděte do kořenového adresáře projektu. V příkazovém prostředí spusťte následující příkaz:

   dotnet build
   

2. Po úspěšném dokončení sestavení spusťte následující příkaz, který spustí webovou aplikaci místně:

   dotnet run
   

3. Pokud pracujete na místním počítači, přejděte v prohlížeči na http://localhost:5000 . Tato adresa je výchozí adresou URL pro místně hostovanou webovou aplikaci. Pokud pracujete v pracovním Azure Cloud Shell, vyberte tlačítko Náhled webu a pak Konfigurovat.

   

   Po zobrazení výzvy ke konfiguraci portu pro verzi Preview zadejte 5000, vyberte Otevřít a procházet. Webová stránka bude číst data z Azure App Configuration.

Vyčištění prostředků

Pokud nechcete dál používat prostředky vytvořené v tomto článku, odstraňte skupinu prostředků, kterou jste tady vytvořili, abyste předešli poplatkům.

1. Přihlaste se k Azure Portala vyberte skupiny prostředků.
2. Do pole filtrovat podle názvu zadejte název vaší skupiny prostředků.
3. V seznamu výsledků vyberte název skupiny prostředků, aby se zobrazil přehled.
4. Vyberte Odstranit skupinu prostředků.
5. Zobrazí se výzva k potvrzení odstranění skupiny prostředků. Zadejte název vaší skupiny prostředků, který chcete potvrdit, a vyberte Odstranit.

Po chvíli se odstraní skupina prostředků a všechny její prostředky.

Další kroky

V tomto rychlém startu:

• Zřízení nového App Configuration úložiště
• Zaregistrovali App Configuration .NET Core v obchodě.
• Přečtěte App Configuration klíče úložiště úložiště s poskytovatelem konfigurace.
• Pomocí App Configuration zobrazí hodnoty klíče v syntaxe Razor.

Informace o tom, jak nakonfigurovat ASP.NET Core aplikaci tak, aby dynamicky obnovuje nastavení konfigurace, najdete v dalším kurzu.