CI/CD işlem hattıyla tümleştirme

  • Makale
  • Okumak için 2 dakika

Bu makalede, Azure Uygulama yapılandırmasından sürekli tümleştirme ve sürekli dağıtım sisteminde verilerin nasıl kullanılacağı açıklanmaktadır.

Azure DevOps işlem hattınızda uygulama yapılandırması 'nı kullanma

Bir Azure DevOps işlem hattına sahipseniz, anahtar değerlerini uygulama yapılandırmasından getirip görev değişkenleri olarak ayarlayabilirsiniz. Azure Uygulama yapılandırması DevOps uzantısı , bu işlevselliği sağlayan bir eklenti modülüdür. Uzantıyı derleme veya yayın görev dizisinde kullanmak için yönergelerini izleyin.

Uygulamanızla uygulama yapılandırma verilerini dağıtma

Uygulamanız Azure Uygulama yapılandırmasına bağımlıysa ve bu uygulamaya ulaşamadıysanız, çalışmayabilir. Yapılandırma verilerini uygulamayla dağıtılan ve uygulamanın başlatılması sırasında yerel olarak yüklenen bir dosyaya paketleyerek uygulamanızın dayanıklılığını geliştirin. Bu yaklaşım, uygulamanızın başlangıçta varsayılan ayar değerlerini olmasını sağlar. Bu değerler, kullanılabilir olduğunda, uygulama yapılandırma deposundaki daha yeni değişikliklerle üzerine yazılır.

Azure Uygulama yapılandırması 'nın dışa aktarma işlevini kullanarak, geçerli yapılandırma verilerini tek bir dosya olarak alma işlemini otomatikleştirebilir. Böylece, bu dosyayı sürekli tümleştirme ve sürekli dağıtım (CI/CD) işlem hattınızdaki bir derleme veya dağıtım adımına katabilirsiniz.

Aşağıdaki örnek, uygulama yapılandırma verilerinin hızlı başlangıçlarda tanıtılan web uygulamasına yönelik derleme adımı olarak nasıl ekleneceğini gösterir. Devam etmeden önce, önce uygulama yapılandırması ile bir ASP.NET Core uygulaması oluşturun .

Bu öğreticideki adımları uygulamak için herhangi bir kod düzenleyicisi kullanabilirsiniz. Visual Studio Code , Windows, MacOS ve Linux platformlarında kullanılabilen harika bir seçenektir.

Önkoşullar

Yerel olarak oluşturursanız, henüz yapmadıysanız Azure CLI 'yi indirip yükleyin.

Azure DevOps ile bir bulut derlemesi yapmak için, Azure CLI 'nın derleme sisteminizde yüklü olduğundan emin olun.

Uygulama yapılandırma deposunu dışa aktarma

  1. . Csproj dosyanızı açın ve aşağıdaki betiği ekleyin:

    <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. Program. cs dosyasını açın ve yöntemini CreateWebHostBuilder çağırarak, dışarıya aktarılmış json dosyasını kullanmak için yöntemi güncelleştirin config.AddJsonFile() . System.ReflectionAd alanını da ekleyin.

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

Uygulamayı yerel olarak derleyin ve çalıştırın

  1. ConnectionString adlı bir ortam değişkeni ayarlayın ve uygulama yapılandırma deponuzu için erişim anahtarı olarak ayarlayın. Windows komut istemi 'ni kullanırsanız, aşağıdaki komutu çalıştırın ve değişikliğin etkili olması için komut istemi ' ni yeniden başlatın:

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

    Windows PowerShell kullanıyorsanız şu komutu çalıştırın:

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

    MacOS veya Linux kullanıyorsanız şu komutu çalıştırın:

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

  2. .NET Core CLI kullanarak uygulamayı derlemek için komut kabuğu 'nda aşağıdaki komutu çalıştırın:

     dotnet build

  3. Oluşturma başarıyla tamamlandıktan sonra, Web uygulamasını yerel olarak çalıştırmak için aşağıdaki komutu çalıştırın:

     dotnet run

  4. Bir tarayıcı penceresi açın ve http://localhost:5000 yerel olarak barındırılan Web uygulaması için varsayılan URL olan adresine gidin.

    Hızlı başlangıç uygulaması başlatma yerel

Sonraki adımlar

Bu öğreticide, bir dağıtım ardışık düzeninde kullanılacak Azure uygulama yapılandırma verilerini aktarmış olursunuz. Uygulama yapılandırmasını kullanma hakkında daha fazla bilgi için Azure CLı örneklerine devam edin.

Azure CLI