Integrera med en CI/CD-pipeline

Den här artikeln förklarar hur du använder data från Azure App konfiguration i en kontinuerlig integrering och ett kontinuerligt distributions system.

Använd app-konfiguration i din Azure DevOps-pipeline

Om du har en Azure DevOps-pipeline kan du hämta nyckel värden från App-konfigurationen och ange dem som variabler för aktiviteter. Tillägget Azure App Configuration DevOps är en modul för tillägg som tillhandahåller den här funktionen. Följ anvisningarna för att använda tillägget i en aktivitetssekvens för att bygga eller släppa.

Distribuera konfigurations data för appar med ditt program

Programmet kanske inte kan köras om det är beroende av Azure App konfiguration och inte kan komma åt det. Förbättra återhämtningen av ditt program genom att paketera konfigurations data i en fil som distribueras med programmet och läsas in lokalt när programmet startas. Den här metoden garanterar att ditt program har standardinställnings värden vid start. Dessa värden skrivs över av eventuella nyare ändringar i konfigurations arkivet för appar när det är tillgängligt.

Med hjälp av export funktionen i Azure App konfiguration kan du automatisera processen med att hämta aktuella konfigurations data som en enda fil. Du kan sedan bädda in den här filen i ett build-eller distributions steg i en pipeline för kontinuerlig integrering och distribution (CI/CD).

I följande exempel visas hur du inkluderar konfigurations data för appar som ett build-steg för webbappen som introduceras i snabb starterna. Innan du fortsätter måste du först skapa en ASP.net Core-app med app-konfigurationen .

Du kan använda valfri kod redigerare för att utföra stegen i den här självstudien. Visual Studio Code är ett utmärkt alternativ som är tillgängligt på Windows-, MacOS-och Linux-plattformarna.

Förutsättningar

Om du skapar lokalt kan du hämta och installera Azure CLI om du inte redan gjort det.

Om du vill göra en moln version kan du till exempel se till att Azure CLI är installerat i versions systemet med Azure DevOps.

Exportera ett konfigurations Arkiv för appen

  1. Öppna din . CSPROJ -fil och Lägg till följande skript:

    <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>
    
  2. Öppna program. cs och uppdatera CreateWebHostBuilder metoden för att använda den exporterade JSON-filen genom att anropa config.AddJsonFile() metoden. Lägg System.Reflection även till namn området.

    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>();
    

Skapa och köra appen lokalt

  1. Ange en miljö variabel med namnet ConnectionString och ange den till åtkomst nyckeln till appens konfigurations arkiv. Om du använder kommando tolken i Windows kör du följande kommando och startar om kommando tolken för att ändringarna ska börja gälla:

     setx ConnectionString "connection-string-of-your-app-configuration-store"
    

    Om du använder Windows PowerShell kör du följande kommando:

     $Env:ConnectionString = "connection-string-of-your-app-configuration-store"
    

    Om du använder macOS eller Linux kör du följande kommando:

     export ConnectionString='connection-string-of-your-app-configuration-store'
    
  2. Om du vill skapa appen med hjälp av .NET Core CLI kör du följande kommando i kommando gränssnittet:

     dotnet build
    
  3. När skapandet har slutförts kör du följande kommando för att köra webbappen lokalt:

     dotnet run
    
  4. Öppna ett webbläsarfönster och gå till http://localhost:5000 , vilket är standard-URL: en för webbappen som finns lokalt.

    Snabbstart av lokal app

Nästa steg

I den här självstudien har du exporterat Azure App konfigurations data som ska användas i en distributions pipeline. Om du vill veta mer om hur du använder app-konfiguration kan du fortsätta till Azure CLI-exemplen.