Integracja z potokiem ciągłej integracji/ciągłego wdrażania

Artykuł
02/28/2024

W tym artykule wyjaśniono, jak używać danych z konfiguracji aplikacja systemu Azure w systemie ciągłej integracji i ciągłego wdrażania.

Używanie konfiguracji aplikacji w potoku usługi Azure DevOps

Jeśli masz potok usługi Azure DevOps, możesz pobrać wartości klucz-wartości z usługi App Configuration i ustawić je jako zmienne zadań. Rozszerzenie aplikacja systemu Azure Configuration DevOps to moduł dodatkowy, który zapewnia tę funkcję. Postępuj zgodnie z instrukcjami, aby użyć rozszerzenia w sekwencji zadań kompilacji lub wydania.

Wdrażanie danych usługi App Configuration za pomocą aplikacji

Uruchomienie aplikacji może zakończyć się niepowodzeniem, jeśli zależy to od aplikacja systemu Azure konfiguracji i nie może nawiązać z nią połączenia. Zwiększ odporność aplikacji, pakując dane konfiguracji do pliku wdrożonego przy użyciu aplikacji i ładowanego lokalnie podczas uruchamiania aplikacji. Takie podejście gwarantuje, że aplikacja ma domyślne wartości ustawień podczas uruchamiania. Te wartości są zastępowane przez wszelkie nowsze zmiany w magazynie usługi App Configuration, gdy są dostępne.

Za pomocą funkcji Export aplikacja systemu Azure Configuration można zautomatyzować proces pobierania bieżących danych konfiguracji jako pojedynczego pliku. Następnie możesz osadzić ten plik w kroku kompilacji lub wdrożenia w potoku ciągłej integracji i ciągłego wdrażania (CI/CD).

W poniższym przykładzie pokazano, jak dołączyć dane usługi App Configuration jako krok kompilacji dla aplikacji internetowej wprowadzonej w przewodnikach Szybki start. Przed kontynuowaniem najpierw zakończ tworzenie aplikacji ASP.NET Core za pomocą usługi App Configuration .

Aby wykonać kroki opisane w tym samouczku, możesz użyć dowolnego edytora kodu. Program Visual Studio Code to doskonała opcja dostępna na platformach Windows, macOS i Linux.

Wymagania wstępne

Jeśli kompilujesz lokalnie, pobierz i zainstaluj interfejs wiersza polecenia platformy Azure, jeśli jeszcze tego nie zrobiono.

Eksportowanie magazynu usługi App Configuration

Otwórz plik csproj i dodaj następujący skrypt:

<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>

Otwórz Program.cs i zaktualizuj metodę CreateWebHostBuilder , aby użyć wyeksportowanego pliku JSON, wywołując metodę config.AddJsonFile() . System.Reflection Dodaj również przestrzeń nazw.

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

Lokalne kompilowanie i uruchamianie aplikacji

Ustaw zmienną środowiskową o nazwie Połączenie ionString i ustaw ją na klucz dostępu do magazynu usługi App Configuration.
Aby skompilować i uruchomić aplikację lokalnie przy użyciu wiersza polecenia systemu Windows, uruchom następujące polecenie i uruchom ponownie wiersz polecenia, aby umożliwić wprowadzenie zmiany:
```
    setx ConnectionString "connection-string-of-your-app-configuration-store"
```
Jeśli używasz programu Windows PowerShell, uruchom następujące polecenie:
```
    $Env:ConnectionString = "connection-string-of-your-app-configuration-store"
```
Jeśli używasz systemu macOS, uruchom następujące polecenie:
```
    export ConnectionString='connection-string-of-your-app-configuration-store'
```
Jeśli używasz systemu Linux, uruchom następujące polecenie:
```
    export ConnectionString='connection-string-of-your-app-configuration-store'
```
Aby skompilować aplikację przy użyciu interfejsu wiersza polecenia platformy .NET, uruchom następujące polecenie w powłoce poleceń:
```
 dotnet build
```
Po pomyślnym zakończeniu kompilacji uruchom następujące polecenie, aby uruchomić aplikację internetową lokalnie:
```
 dotnet run
```
Otwórz okno przeglądarki i przejdź do http://localhost:5000adresu , który jest domyślnym adresem URL aplikacji internetowej hostowanej lokalnie.

Następne kroki

W tym samouczku wyeksportowano dane konfiguracji aplikacja systemu Azure do użycia w potoku wdrażania. Aby dowiedzieć się więcej na temat korzystania z usługi App Configuration, przejdź do przykładów interfejsu wiersza polecenia platformy Azure.

Interfejs wiersza polecenia platformy Azure