Rövid útmutató: ASP.NET Core-alkalmazás létrehozása Azure-alkalmazás Konfigurációval

Ebben a kezdeti lépésekben az Azure App Configuration használatával külsőleg tárolhatja és kezelheti az alkalmazásbeállításait egy ASP.NET Core-alkalmazáshoz. ASP.NET Core egyetlen kulcs-érték alapú konfigurációs objektumot hoz létre egy vagy több konfigurációszolgáltató beállításainak használatával. Az Alkalmazáskonfiguráció .NET-konfigurációszolgáltatói kódtárat kínál. Ezért az Alkalmazáskonfigurációt további konfigurációs forrásként használhatja az alkalmazáshoz. Ha már rendelkezik alkalmazással, az alkalmazáskonfiguráció használatához csak néhány kisebb módosításra lesz szüksége az alkalmazás indítási kódjában.

Előfeltételek

• Egy Azure-fiók, aktív előfizetéssel. Hozzon létre egyet ingyen.
• Egy alkalmazáskonfigurációs áruház, ahogyan az egy áruház létrehozására vonatkozó oktatóanyagban is látható.
• .NET SDK 6.0 vagy újabb

Tipp

Az Azure Cloud Shell egy ingyenes, interaktív rendszerhéj, amellyel futtathatja a cikkben szereplő parancssori utasításokat. Gyakran telepített Azure-eszközökkel rendelkezik, beleértve a .NET SDK-t is. Ha az Azure-előfizetésébe bejelentkezve van, indítsa el az Azure Cloud Shellt a shell.azure.com oldalon. Az Azure Cloud Shellről a dokumentációnk elolvasásával tudhat meg többet

Kulcsértékek hozzáadása

Adja hozzá az alábbi kulcsértékeket az Alkalmazáskonfigurációs áruházhoz, és hagyja meg a címke és a tartalomtípus alapértelmezett értékeit. Ha többet szeretne tudni arról, hogyan adhat hozzá kulcsértékeket egy áruházhoz az Azure Portal vagy a parancssori felület használatával, lépjen a Kulcs-érték létrehozása elemre.

Kulcs	Érték
TestApp:Settings:BackgroundColor	fehér
TestApp:Settings:FontColor	fekete
TestApp:Settings:FontSize	24
TestApp:Settings:Message	Adatok Azure-alkalmazás konfigurációjából

ASP.NET Core-webalkalmazás létrehozása

A .NET parancssori felület (CLI) használatával hozzon létre egy új ASP.NET Core-webalkalmazás-projektet. Az Azure Cloud Shell ezeket az eszközöket biztosítja Önnek. Windows, macOS és Linux platformokon is elérhetők.

Futtassa a következő parancsot egy ASP.NET Core-webalkalmazás létrehozásához egy új TestAppConfig mappában:

dotnet new webapp --output TestAppConfig

Csatlakozás az Alkalmazáskonfigurációs áruházhoz

Csatlakozzon az alkalmazáskonfigurációs áruházhoz a Microsoft Entra ID (ajánlott) vagy egy kapcsolati karakterlánc használatával.

1. Lépjen a projekt könyvtárába , a TestAppConfigba, és futtassa a következő parancsot a NuGet-csomaghivatkozások hozzáadásához.

   Microsoft Entra-azonosító (ajánlott)

   dotnet add package Microsoft.Azure.AppConfiguration.AspNetCore
   dotnet add package Azure.Identity
   

   Kapcsolati string

   dotnet add package Microsoft.Azure.AppConfiguration.AspNetCore
   

2. Hozzon létre egy felhasználói titkos kulcsot az alkalmazáshoz a TestAppConfig mappába lépve, és futtassa a következő parancsot.

   Microsoft Entra-azonosító (ajánlott)

   A parancs a Secret Manager-t használja egy Endpoints:AppConfiguration nevű titok tárolására, amely az alkalmazáskonfigurációs tároló végpontját tárolja. Cserélje le a <your-App-Configuration-endpoint> helyőrzőt az App Configuration áruház végpontjára. A végpontot az Alkalmazáskonfigurációs áruház Áttekintés paneljén találja az Azure Portalon.

   dotnet user-secrets init
   dotnet user-secrets set Endpoints:AppConfiguration "<your-App-Configuration-endpoint>"
   

   Kapcsolati string

   A parancs a Secret Manager-t használja egy ConnectionStrings:AppConfiguration nevű titkos kód tárolásához, amely az Alkalmazáskonfigurációs áruház kapcsolati sztringjét tartalmazza. Cserélje le a <your-App-Configuration-connection-string> helyőrzőt az App Configuration Store írásvédett kapcsolati láncával. A kapcsolati sztringet az Azure portálon, az Alkalmazáskonfiguráció tárházának Access-beállításai között találja meg.

   dotnet user-secrets init
   dotnet user-secrets set ConnectionStrings:AppConfiguration "<your-App-Configuration-connection-string>"
   

   Tipp

   Egyes rendszerhéjak csonkítják a kapcsolati karaktersort, hacsak nincsen idézőjelek közé zárva. Győződjön meg arról, hogy a dotnet user-secrets list parancs kimenete a teljes kapcsolati sztring jeleníti meg. Ha nem működik, futtassa újra a parancsot, és foglalja idézőjelekbe a kapcsolati karakterláncot.

   A Titkos kulcskezelő a projektfán kívül tárolja a titkos kulcsokat, ami segít megelőzni a titkos kódok véletlen megosztását a forráskódban. Csak a webalkalmazás helyi tesztelésére használható. Amikor az alkalmazást üzembe helyezik az Azure-ban, például az App Service-ben, használja a kapcsolati sztringeket, az alkalmazásbeállításokat vagy a környezeti változókat a kapcsolati sztring tárolásához. A kapcsolati karakterláncok teljes elkerülése érdekében csatlakozhat az Alkalmazáskonfigurációhoz felügyelt identitások vagy más Microsoft Entra-identitások használatával.

3. Nyissa meg Program.cs , és adja hozzá a következő névtereket:

   Microsoft Entra-azonosító (ajánlott)

   using Microsoft.Extensions.Configuration;
   using Microsoft.Azure.AppConfiguration.AspNetCore;
   using Azure.Identity;
   

   Kapcsolati string

   using Microsoft.Extensions.Configuration;
   using Microsoft.Azure.AppConfiguration.AspNetCore;
   

4. Csatlakozzon az Alkalmazáskonfigurációs áruházhoz a AddAzureAppConfiguration fájlban található Program.cs metódus meghívásával.

   Microsoft Entra-azonosító (ajánlott)

   A DefaultAzureCredential segítségével hitelesítheti magát az alkalmazáskonfigurációs tárolóban. Kövesse az utasításokat a hitelesítő adatainak App Configuration Data Reader szerepkör hozzárendeléséhez. Győződjön meg arról, hogy elegendő időt hagy az engedély propagálására az alkalmazás futtatása előtt.

   var builder = WebApplication.CreateBuilder(args); 
   
   // Retrieve the endpoint
   string endpoint = builder.Configuration.GetValue<string>("Endpoints:AppConfiguration")
       ?? throw new InvalidOperationException("The setting `Endpoints:AppConfiguration` was not found.");
   
   // Load configuration from Azure App Configuration 
   builder.Configuration.AddAzureAppConfiguration(options =>
   {
       options.Connect(new Uri(endpoint), new DefaultAzureCredential());
   });
   
   // The rest of existing code in program.cs
   // ... ...    
   

   Kapcsolati string

   var builder = WebApplication.CreateBuilder(args);
   
   // Retrieve the connection string
   string connectionString = builder.Configuration.GetConnectionString("AppConfiguration")
       ?? throw new InvalidOperationException("The connection string 'AppConfiguration' was not found.");
   
   // Load configuration from Azure App Configuration
   builder.Configuration.AddAzureAppConfiguration(connectionString);
   
   // The rest of existing code in program.cs
   // ... ...
   

   Ez a kód betölti az összes olyan kulcsértéket, amely nem tartalmaz címkét az Alkalmazáskonfigurációs áruházból. Az adatok alkalmazáskonfigurációból való betöltéséről az alkalmazáskonfiguráció szolgáltatójának API-referenciája nyújt további információt.

Alkalmazás konfigurációs tárolóból olvasni

Ebben a példában frissíteni fog egy weblapot, hogy annak tartalma megjelenjen az Alkalmazáskonfigurációs áruházban konfigurált beállításokkal.

1. Adjon hozzá egy Settings.cs fájlt a projektkönyvtár gyökeréhez. Ez egy erősen beírt osztályt Settings határoz meg a használni kívánt konfigurációhoz. Cserélje le a névteret a projekt nevére.

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

2. Kösse össze a TestApp:Settings szakaszt a konfigurációban az Settings objektummal.

   Frissítse Program.cs a következő kóddal, és adja hozzá a TestAppConfig névteret a fájl elején.

   using TestAppConfig;
   
   // Existing code in Program.cs
   // ... ...
   
   builder.Services.AddRazorPages();
   
   // Bind configuration "TestApp:Settings" section to the Settings object
   builder.Services.Configure<Settings>(builder.Configuration.GetSection("TestApp:Settings"));
   
   var app = builder.Build();
   
   // The rest of existing code in program.cs
   // ... ...
   

3. Nyissa meg Index.cshtml.cs a Pages könyvtárban, és frissítse az osztályt az alábbi kóddal.IndexModel Adja hozzá a using Microsoft.Extensions.Options névteret a fájl elejéhez, ha még nincs megadva.

   public class IndexModel : PageModel
   {
       private readonly ILogger<IndexModel> _logger;
   
       public Settings Settings { get; }
   
       public IndexModel(IOptionsSnapshot<Settings> options, ILogger<IndexModel> logger)
       {
           Settings = options.Value;
           _logger = logger;
       }
   }
   

4. Nyissa meg az Index.cshtml fájlt a Pages könyvtárban, és frissítse a tartalmat a következő kóddal.

   @page
   @model IndexModel
   @{
       ViewData["Title"] = "Home page";
   }
   
   <style>
       body {
           background-color: @Model.Settings.BackgroundColor;
       }
   
       h1 {
           color: @Model.Settings.FontColor;
           font-size: @(Model.Settings.FontSize)px;
       }
   </style>
   
   <h1>@Model.Settings.Message</h1>
   

Az alkalmazás helyi létrehozása és futtatása

1. Ha az alkalmazást a .NET CLI használatával szeretné létrehozni, keresse meg a projekt gyökérkönyvtárát. Futtassa a következő parancsot a parancsfelületen:

   dotnet build
   

2. A build sikeres befejezése után futtassa a következő parancsot a webalkalmazás helyi futtatásához:

   dotnet run
   

3. A parancs kimenete dotnet run két URL-címet tartalmaz. Nyisson meg egy böngészőt, és keresse meg valamelyik URL-címet az alkalmazás eléréséhez. Például: https://localhost:5001

   Ha az Azure Cloud Shellben dolgozik, válassza a Web Preview gombot, majd a Konfigurálás elemet. Amikor a rendszer kéri a port előzetes verzióra való konfigurálását, írja be az 5000-et, és válassza a Megnyitás és tallózás lehetőséget.

   

   A weblap a következőképpen néz ki:

Az erőforrások megtisztítása

Ha nem szeretné folytatni a cikkben létrehozott erőforrások használatát, törölje az itt létrehozott erőforráscsoportot a díjak elkerülése érdekében.

Fontos

Az erőforráscsoport törlése nem vonható vissza. Az erőforráscsoport és a benne lévő összes erőforrás véglegesen törlődik. Győződjön meg arról, hogy nem véletlenül törli a rossz erőforráscsoportot vagy erőforrásokat. Ha a cikk erőforrásait olyan erőforráscsoporton belül hozta létre, amely más megtartani kívánt erőforrásokat tartalmaz, törölje az egyes erőforrásokat a megfelelő panelről az erőforráscsoport törlése helyett.

1. Jelentkezzen be az Azure Portalra, és válassza ki az Erőforráscsoportokat.
2. A Szűrés név szerint mezőbe írja be az erőforráscsoport nevét.
3. Az eredménylistában válassza ki az erőforráscsoport nevét az áttekintés megtekintéséhez.
4. Válassza az Erőforráscsoport törlése elemet.
5. A rendszer az erőforráscsoport törlésének megerősítését kéri. Adja meg a megerősítéshez az erőforráscsoport nevét, és válassza a Törlés lehetőséget.

Néhány pillanat múlva az erőforráscsoport és annak összes erőforrása törlődik.

Következő lépések

Ebben a rövid útmutatóban a következőket fogjuk elvégezni:

• Létrehozott egy új alkalmazáskonfigurációs tárolót.
• Az Alkalmazáskonfigurációs tár használatával csatlakozik az alkalmazáskonfigurációs áruházhoz.
• Olvassa el az alkalmazáskonfigurációs tárhely kulcsértékeit a konfigurációszolgáltató könyvtárral.
• Megjelenített egy weblapot az App Configuration Store-ban konfigurált beállításokkal.

Ha szeretné megtudni, hogyan konfigurálhatja a ASP.NET Core-webalkalmazást a konfigurációs beállítások dinamikus frissítésére, folytassa a következő oktatóanyaggal.

Dinamikus konfiguráció engedélyezése