appsettings.json → .env Dönüştürücü Nedir?

appsettings.json → .env Dönüştürücü, ASP.NET Core yapılandırma dosyalarını ortam değişkeni formatına (.env) dönüştürerek ayarları yerel geliştirme, Docker ve bulut ortamları arasında taşımayı kolaylaştırır.

appsettings.json Neden .env'e Dönüştürülür?

Docker & konteynerler: Konteyner ortamları JSON dosyaları yerine düz ortam değişkenlerini tercih eder.
12-factor uygulamalar: 12-factor metodolojisi, taşınabilirlik ve güvenlik için yapılandırmanın ortam değişkenlerinde saklanmasını önerir.
CI/CD iş akışları: Çoğu CI/CD platformu (GitHub Actions, GitLab, Azure DevOps) yapılandırmayı dosya değil, ortam değişkeni olarak enjekte eder.
Bulut barındırma: Azure App Service, Heroku ve Railway gibi platformlar ortam değişkenlerini doğrudan kabul eder.

ASP.NET Core Ortam Değişkenlerini Nasıl Okur?

ASP.NET Core'un yapılandırma sistemi, iç içe JSON anahtarlarını ayırıcı olarak çift alt çizgi (__) kullanarak ortam değişkenlerine eşler. Örneğin:

ConnectionStrings:DefaultConnection → ConnectionStrings__DefaultConnection
Jwt:Secret → Jwt__Secret
Logging:LogLevel:Default → Logging__LogLevel__Default

Bu araç bu eşlemeyi otomatik olarak uygular; dönüştürülen değişkenleriniz ASP.NET Core'un ortam değişkeni yapılandırma sağlayıcısıyla doğrudan çalışır.

Dosya Türü Ön Ayarları

appsettings.json: Tüm ortamlar arasında paylaşılan temel yapılandırma.
appsettings.Development.json: Yerel geliştirme için geçersiz kılmalar (ayrıntılı günlükleme, yerel DB bağlantıları).
appsettings.Production.json: Üretim için geçersiz kılmalar (kısıtlı günlükleme, üretim gizli anahtarları).

Özellikler

Derin iç içe JSON'u destekler — __ ayırıcısıyla otomatik olarak düzleştirilir
Çift alt çizgi, iki nokta veya tek alt çizgi anahtar ayırıcıları arasından seçin
Boşluk veya özel karakter içeren değerler otomatik olarak tırnak içine alınır
Development veya Production appsettings dosyaları için ön ayarları yükleyin
Sonucu tek tıklamayla panoya kopyalayın
Tamamen istemci taraflı — gizli anahtarlarınız asla tarayıcınızdan çıkmaz

Nasıl Kullanılır

Ayarlar panelinden dosya türünü (temel, Development veya Production) seçin ya da kendi JSON'ınızı doğrudan yapıştırın.
Tercih ettiğiniz anahtar ayırıcıyı seçin (çift alt çizgi ASP.NET Core varsayılanıdır).
Dönüştür'e tıklayın veya sonucu görmek için .env sekmesine geçin.
Çıktıyı kopyalayın ve .env dosyanıza veya CI/CD iş akışı gizli anahtarlarınıza yapıştırın.