Farklı Ortamlar İçin Konfigürasyon Yönetimi

Uygulama geliştirme sürecinde test, geliştirme ve üretim gibi farklı ortamlar için farklı IP adresleri veya endpoint'lerin yönetilmesi gerekir. Her ortamın kendine özgü ayarları ve endpoint bilgileri olabilir. Kuika platformunda bu yönetimi konfigürasyon dosyaları aracılığıyla otomatik hâle getirebilirsiniz. Bu eğitim içeriğinde farklı ortamlar için konfigürasyon yönetimini ve appsettings.json dosyasından veri okuma süreçlerini öğreneceksiniz.

Ortam Farklılıklarına Göre Konfigürasyon Yönetimi

Adım 1: Ortamlarınızı Tanımlayın

Uygulamanızın test, geliştirme ve üretim ortamlarında çalışması gerekiyorsa, bu ortamlar için farklı IP adresleri veya endpoint'ler kullanabilirsiniz. Ortam bazlı ayarların otomatikleştirilmesi, her yayında manuel değişiklik yapma ihtiyacını ortadan kaldırır.

Adım 2: appsettings.json Dosyasını Yapılandırın

Her ortam için IP adreslerini veya endpoint'leri appsettings.json dosyasında saklayabilirsiniz. Her ortamın appsettings.json dosyasında aynı anahtarı kullanın ve yalnızca değeri ortama göre değiştirin. Örneğin:

Test ortamı:

"MySettings": {
  "testVar": "https://test-api.example.com"
}

Geliştirme ortamı:

"MySettings": {
  "testVar": "https://dev-api.example.com"
}

Üretim ortamı:

"MySettings": {
  "testVar": "https://api.example.com"
}

Adım 3: Ortam Bilgisine Göre Veri Okuyan C# Fonksiyonunu Oluşturun

Farklı ortamlardaki verileri uygulamanızda dinamik olarak okumak için özel bir C# fonksiyonu oluşturabilirsiniz.

1. Kuika platformuna giriş yapın.
2. Apps ekranından çalışacağınız projeyi açın.
3. Üst menüden Datasources modülüne gidin.

4. Create a Function kartına tıklayın.
5. Açılan listede Development başlığı altındaki C# Functions seçeneğini seçin.

6. Açılan editörün üst kısmındaki düzenleme (kalem) ikonuna tıklayarak fonksiyona bir isim verin.
7. Editöre aşağıdaki kodu yazın:

using Kuika.Common.Attributes;
using Kuika.Common.Enums;
using Newtonsoft.Json;
using System;
using System.Text.Json.Serialization;

namespace Kuika.ThirdPartyApisCollection
{
    public class GetVariableClass
    {
        public static string GetVariable()
        {
            var variable = ConfigurationHelper.GetEnvinronmentOrAppSettings<MySettings>("testVar");
            return variable.TestVar;
        }
    }

    [KSettingSectionName("MySettings")]
    public class MySettings
    {
        [JsonProperty("testVar")]
        [JsonPropertyName("testVar")]
        public string TestVar { get; set; }
    }
}

8. Sağ üst köşedeki Create butonuna tıklayarak fonksiyonu oluşturun.

Editörün sağ panelindeki Kuika AI ile C# fonksiyonlarınızı oluştururken yapay zekâ desteği alabilir, alt kısımdaki Test Console alanında kodunuzu test edebilirsiniz.

Adım 4: Ortam Bilgisine Göre Otomatik Veri Kullanımı

GetVariable() fonksiyonu, uygulamanın çalıştığı ortamın appsettings.json dosyasındaki MySettings bölümünü okuyarak ilgili IP veya endpoint değerini döndürür.

Adım 5: Yayınlama Sürecinde Kolaylık

Bu yapı sayesinde her yayın öncesinde farklı ortamlar için IP veya endpoint bilgilerini manuel olarak değiştirmeniz gerekmez. Uygulama, çalıştığı ortama göre doğru ayarları otomatik olarak kullanır.

Bu eğitim içeriğinde Kuika platformunda farklı ortamlar için konfigürasyon yönetimini ve appsettings.json dosyasından veri okuma süreçlerini öğrendiniz.