Integrar num pipeline CI/CD

Artigo
02/28/2024

Este artigo explica como usar dados da Configuração de Aplicativo do Azure em um sistema de integração contínua e implantação contínua.

Usar a Configuração do Aplicativo em seu Pipeline de DevOps do Azure

Se você tiver um Pipeline de DevOps do Azure, poderá buscar valores-chave na Configuração do Aplicativo e defini-los como variáveis de tarefa. A extensão Azure App Configuration DevOps é um módulo complementar que fornece essa funcionalidade. Siga suas instruções para usar a extensão em uma sequência de tarefas de compilação ou lançamento.

Implantar dados de configuração do aplicativo com seu aplicativo

Seu aplicativo pode falhar ao ser executado se depender da Configuração do Aplicativo do Azure e não puder acessá-lo. Melhore a resiliência do seu aplicativo empacotando dados de configuração em um arquivo que é implantado com o aplicativo e carregado localmente durante a inicialização do aplicativo. Essa abordagem garante que seu aplicativo tenha valores de configuração padrão na inicialização. Esses valores são substituídos por quaisquer alterações mais recentes em uma loja de configuração de aplicativos quando ela estiver disponível.

Usando a função Exportar da Configuração do Aplicativo do Azure, você pode automatizar o processo de recuperação de dados de configuração atuais como um único arquivo. Em seguida, você pode incorporar esse arquivo em uma etapa de compilação ou implantação em seu pipeline de integração contínua e implantação contínua (CI/CD).

O exemplo a seguir mostra como incluir dados de Configuração do Aplicativo como uma etapa de compilação para o aplicativo Web introduzido nos inícios rápidos. Antes de continuar, conclua primeiro Criar um aplicativo ASP.NET Core com a Configuração do Aplicativo.

Você pode usar qualquer editor de código para executar as etapas neste tutorial. O Visual Studio Code é uma excelente opção disponível nas plataformas Windows, macOS e Linux.

Pré-requisitos

Se você compilar localmente, baixe e instale a CLI do Azure, se ainda não o tiver feito.

Exportar uma loja de configuração de aplicativos

Abra o arquivo .csproj e adicione o seguinte script:

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

Abra Program.cs e atualize o CreateWebHostBuilder método para usar o arquivo JSON exportado chamando o config.AddJsonFile() método. Adicione o System.Reflection namespace também.

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

Crie e execute o aplicativo localmente

Defina uma variável de ambiente chamada ConnectionString e defina-a como a chave de acesso à sua loja de configuração de aplicativos.
Para criar e executar o aplicativo localmente usando o prompt de comando do Windows, execute o seguinte comando e reinicie o prompt de comando para permitir que a alteração entre em vigor:
```
    setx ConnectionString "connection-string-of-your-app-configuration-store"
```
Se você usar o Windows PowerShell, execute o seguinte comando:
```
    $Env:ConnectionString = "connection-string-of-your-app-configuration-store"
```
Se você usa macOS, execute o seguinte comando:
```
    export ConnectionString='connection-string-of-your-app-configuration-store'
```
Se você usa Linux, execute o seguinte comando:
```
    export ConnectionString='connection-string-of-your-app-configuration-store'
```
Para criar o aplicativo usando a CLI do .NET, execute o seguinte comando no shell de comando:
```
 dotnet build
```
Depois que a compilação for concluída com êxito, execute o seguinte comando para executar o aplicativo Web localmente:
```
 dotnet run
```
Abra uma janela do navegador e vá para http://localhost:5000, que é a URL padrão para o aplicativo Web hospedado localmente.

Próximos passos

Neste tutorial, você exportou dados de Configuração do Aplicativo do Azure para serem usados em um pipeline de implantação. Para saber mais sobre como usar a Configuração do Aplicativo, continue para os exemplos da CLI do Azure.

CLI do Azure

Share via