Integrace s kanálem CI/CD

Tento článek vysvětluje, jak používat data z Azure App Configuration v systému kontinuální integrace a kontinuálního nasazování.

Použití konfigurace aplikací ve vašem kanálu Azure DevOps

Pokud máte kanál Azure DevOps, můžete načíst hodnoty klíčů z App Configuration a nastavit je jako proměnné úloh. Rozšíření Azure App Configuration DevOps je modul, který tuto funkci poskytuje. Získejte tento modul a projděte si informace o exportu nastavení z konfigurace aplikace pomocí Azure Pipelines , kde najdete pokyny k jeho použití ve službě Azure Pipelines.

Nasazení dat app Configuration pomocí aplikace

Vaše aplikace se nemusí spustit, pokud závisí na konfiguraci Aplikace Azure a nemůže se k ní připojit. Zvyšte odolnost aplikace zabalením konfiguračních dat do souboru nasazeného s aplikací a místně načteným během spuštění aplikace. Tento přístup zaručuje, že vaše aplikace má při spuštění výchozí hodnoty nastavení. Tyto hodnoty se přepíšou všemi novějšími změnami v obchodě App Configuration Store, pokud jsou k dispozici.

Pomocí funkce Export Aplikace Azure Configuration můžete automatizovat proces načítání aktuálních konfiguračních dat jako jednoho souboru. Tento soubor pak můžete vložit do kroku sestavení nebo nasazení do kanálu kontinuální integrace a průběžného nasazování (CI/CD).

Následující příklad ukazuje, jak zahrnout data App Configuration jako krok sestavení pro webovou aplikaci, která byla představena v rychlých začátcích. Než budete pokračovat, nejprve dokončete vytvoření aplikace ASP.NET Core s konfigurací aplikace.

Kroky v tomto kurzu můžete provést pomocí libovolného editoru kódu. Visual Studio Code je vynikající volbou na platformách Windows, macOS a Linux.

Požadavky

Pokud vytváříte místně, stáhněte a nainstalujte Azure CLI , pokud jste to ještě neudělali.

Export úložiště konfigurace aplikace

1. Otevřete soubor .csproj a přidejte následující 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. Otevřete Program.cs a aktualizujte metodu CreateWebHostBuilder tak, aby používala exportovaný soubor JSON voláním config.AddJsonFile() metody. Také přidejte obor názvů System.Reflection.

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

Sestavení a místní spuštění aplikace

1. Nastavte proměnnou prostředí s názvem ConnectionString a nastavte ji na přístupový klíč k vašemu App Configuration Storu.

   Příkazový řádek windows

   Pokud chcete aplikaci sestavit a spustit místně pomocí příkazového řádku Windows, spusťte následující příkaz a restartujte příkazový řádek, aby se změna projevila:

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

   PowerShell

   Pokud používáte Windows PowerShell, spusťte následující příkaz:

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

   macOS

   Pokud používáte macOS, spusťte následující příkaz:

       export ConnectionString='<connection-string-of-your-app-configuration-store>'
   

   Linux

   Pokud používáte Linux, spusťte následující příkaz:

       export ConnectionString='<connection-string-of-your-app-configuration-store>'
   

2. Pokud chcete aplikaci sestavit pomocí rozhraní příkazového řádku .NET CLI, spusťte v příkazovém prostředí následující příkaz:

    dotnet build
   

3. Po úspěšném dokončení sestavení spusťte následující příkaz a spusťte webovou aplikaci místně:

    dotnet run
   

4. Otevřete okno prohlížeče a přejděte na http://localhost:5000výchozí adresu URL webové aplikace hostované místně.

   

Další kroky

V tomto kurzu jste exportovali konfigurační data Azure App Configuration pro použití v nasazovacím kanálu. Další informace o používání služby App Configuration najdete v ukázkách Azure CLI.

Azure CLI