Integráció CI-/CD-folyamattal

Cikk
03/05/2024

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 a config.AddJsonFile() metódus meghívásával. Adja hozzá a System.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"
```
Windows PowerShell használata esetén futtassa a következő parancsot:
```
    $Env:ConnectionString = "connection-string-of-your-app-configuration-store"
```
MacOS használata esetén futtassa a következő parancsot:
```
    export ConnectionString='connection-string-of-your-app-configuration-store'
```
Linux használata esetén futtassa a következő parancsot:
```
    export 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:5000a 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.

Azure CLI