Integráció CI-/CD-folyamattal
Ez a cikk azt ismerteti, hogyan használhatja a Azure-alkalmazás Konfigurációból származó adatokat egy folyamatos integrációs és folyamatos üzembe helyezési rendszerben.
Alkalmazáskonfiguráció használata az Azure DevOps-folyamatban
Ha rendelkezik Azure DevOps-folyamatokkal, lekérheti a kulcsértékeket az Alkalmazáskonfigurációból, és feladatváltozókként állíthatja be őket. A Azure-alkalmazás Configuration DevOps bővítmény egy bővítménymodul, amely biztosítja ezt a funkciót. Kövesse az utasításokat a bővítmény buildelési vagy kiadási feladatütemezésben való használatához.
Alkalmazáskonfigurációs adatok üzembe helyezése az alkalmazással
Előfordulhat, hogy az alkalmazás nem fut, ha Azure-alkalmazás konfigurációtól függ, és nem éri el. Az alkalmazás rugalmasságának növeléséhez csomagolja a konfigurációs adatokat az alkalmazással üzembe helyezett és az alkalmazás indításakor helyileg betöltött fájlba. Ez a megközelítés garantálja, hogy az alkalmazás indításkor alapértelmezett beállítási értékekkel rendelkezik. Ezeket az értékeket felülírja az alkalmazáskonfigurációs áruházban az elérhető újabb módosítások.
A Azure-alkalmazás Configuration Exportálás funkciójának használatával automatizálhatja az aktuális konfigurációs adatok egyetlen fájlként való lekérésének folyamatát. Ezután beágyazhatja ezt a fájlt egy buildelési vagy üzembe helyezési lépésbe a folyamatos integrációs és folyamatos üzembe helyezési (CI/CD) folyamatba.
Az alábbi példa bemutatja, hogyan lehet alkalmazáskonfigurációs adatokat beépíteni a rövid útmutatókban bemutatott webalkalmazás buildelési lépéseként. A folytatás előtt először fejezze be a ASP.NET Core-alkalmazás létrehozása az alkalmazáskonfigurációval .
Az oktatóanyag lépéseit bármely kódszerkesztővel elvégezheti. A Visual Studio Code kiváló lehetőség Windows, macOS és Linux platformokon.
Előfeltételek
Helyi buildelés esetén töltse le és telepítse az Azure CLI-t , ha még nem tette meg.
Alkalmazáskonfigurációs áruház exportálása
Nyissa meg a .csproj fájlt, és adja hozzá a következő szkriptet:
<Target Name="Export file" AfterTargets="Build"> <Message Text="Export the configurations to a temp file. " /> <Exec WorkingDirectory="$(MSBuildProjectDirectory)" Condition="$(ConnectionString) != ''" Command="az appconfig kv export -d file --path $(OutDir)\azureappconfig.json --format json --separator : --connection-string $(ConnectionString)" /> </Target>
Nyissa meg a Program.cs, és frissítse a
CreateWebHostBuilder
metódust az exportált JSON-fájl használatára aconfig.AddJsonFile()
metódus meghívásával. Adja hozzá aSystem.Reflection
névteret is.public static IWebHostBuilder CreateWebHostBuilder(string[] args) => WebHost.CreateDefaultBuilder(args) .ConfigureAppConfiguration((hostingContext, config) => { var directory = System.IO.Path.GetDirectoryName(Assembly.GetExecutingAssembly().Location); var settings = config.Build(); config.AddJsonFile(Path.Combine(directory, "azureappconfig.json")); config.AddAzureAppConfiguration(settings["ConnectionStrings:AppConfig"]); }) .UseStartup<Startup>();
Az alkalmazás helyi létrehozása és futtatása
Állítson be egy Csatlakozás ionString nevű környezeti változót, és állítsa be az App Configuration Store hozzáférési kulcsára.
Ha helyileg szeretné létrehozni és futtatni az alkalmazást a Windows parancssorával, futtassa a következő parancsot, majd indítsa újra a parancssort a módosítás érvénybe lépésének engedélyezéséhez:
setx ConnectionString "connection-string-of-your-app-configuration-store"
Ha az alkalmazást a .NET CLI használatával szeretné létrehozni, futtassa a következő parancsot a parancshéjban:
dotnet build
A build sikeres befejezése után futtassa a következő parancsot a webalkalmazás helyi futtatásához:
dotnet run
Nyisson meg egy böngészőablakot, és lépjen
http://localhost:5000
a helyileg üzemeltetett webalkalmazás alapértelmezett URL-címére.
Következő lépések
Ebben az oktatóanyagban exportálta Azure-alkalmazás konfigurációs adatokat, amelyeket egy üzembehelyezési folyamatban kell használni. Ha többet szeretne megtudni az alkalmazáskonfiguráció használatáról, folytassa az Azure CLI-mintákkal.