Azure Uygulaması Yapılandırması hakkında SSS

Uygulama Yapılandırması, geliştiricilerin uygulama ayarlarını yönetmelerine ve özellik kullanılabilirliğini denetlemelerine yardımcı olur. Karmaşık yapılandırma verileriyle çalışma görevlerinin çoğunu basitleştirmeyi amaçlar.

Uygulama Yapılandırması destekler:

• Hiyerarşik ad alanları
• Etiketleme
• Kapsamlı sorgular
• Toplu alma
• Özel yönetim işlemleri
• Özellik yönetimi kullanıcı arabirimi

Uygulama Yapılandırması Key Vault'a tamamlar ve bu ikisi çoğu uygulama dağıtımında yan yana kullanılmalıdır.

Uygulama Yapılandırması sağlamlaştırılmış güvenlik sağlasa da, Key Vault yine de uygulama gizli dizilerini depolamak için en iyi yerdir. Key Vault donanım düzeyinde şifreleme, ayrıntılı erişim ilkeleri ve sertifika döndürme gibi yönetim işlemleri sağlar.

Key Vault'ta depolanan gizli dizilere başvuran Uygulama Yapılandırması anahtar değerleri oluşturabilirsiniz. Daha fazla bilgi için bkz . ASP.NET Core uygulamasında Key Vault başvurularını kullanma.

Evet. Uygulama Yapılandırması aktarımdaki ve bekleyen tüm verileri her zaman şifreler. Tüm ağ iletişimi TLS 1.2 veya TLS 1.3 üzerinden yapılır. Uygulama Yapılandırması, bekleyen şifrelemeyi ikisiyle de desteklerMicrosoft tarafından yönetilen anahtarlar veya müşteri tarafından yönetilen anahtarlar.

Azure Uygulaması Hizmeti, her App Service örneği için uygulama ayarlarını tanımlamanıza olanak tanır. Bu ayarlar, uygulama koduna ortam değişkenleri olarak geçirilir. İsterseniz bir ayarı belirli bir dağıtım yuvasıyla ilişkilendirebilirsiniz. Daha fazla bilgi için bkz . Uygulama ayarlarını yapılandırma.

Buna karşılık, Azure Uygulaması Yapılandırması birden çok uygulama arasında paylaşılabilen ayarları tanımlamanıza olanak tanır. Buna App Service'te çalışan uygulamaların yanı sıra diğer platformlar da dahildir. Uygulama kodunuz bu ayarlara .NET ve Java yapılandırma sağlayıcıları aracılığıyla, Azure SDK aracılığıyla veya doğrudan REST API'leri aracılığıyla erişir.

App Service'inizin Uygulama ayarlarından Uygulama Yapılandırması verilerinize başvurular ekleyebilirsiniz. App Service ile Uygulama Yapılandırması arasında da ayarları içeri ve dışarı aktarabilirsiniz. Bu özellik, mevcut App Service ayarlarına göre hızlı bir şekilde yeni bir Uygulama Yapılandırması deposu ayarlamanıza olanak tanır. Yapılandırmayı App Service ayarlarına bağlı olan mevcut bir uygulamayla da paylaşabilirsiniz.

Etiket, içerik türü, etiketler ve diğer meta veriler gibi öznitelikler de dahil olmak üzere tek bir anahtar değeri için 10 KB sınırı vardır. Toplam boyutları depolama sınırının altında olduğu sürece anahtar ve etiket sayısında bir sınır yoktur.

Bu anahtar-değer sınırı çoğu uygulamada tek bir ayar için yeterli olmalıdır. Ayarınızın bu sınırdan daha büyük olduğunu fark ederseniz verilerinizi başka bir yerde depolamayı ve bu verilerin başvurularını Uygulama Yapılandırması ekleyebilirsiniz.

Sınırların tam listesi için bkz . Azure aboneliği ve hizmet sınırları.

Uygulama Yapılandırması kimlerin mağaza düzeyinde erişebileceğini siz denetlersiniz. Farklı izinler gerektiren her ortam için ayrı bir depo kullanın. Bu yaklaşım en iyi güvenlik yalıtımını sağlar.

Ortamlar arasında güvenlik yalıtımına ihtiyacınız yoksa, yapılandırma değerlerini ayırt etmek için etiketleri kullanabilirsiniz. Farklı ortamlar için farklı yapılandırmaları etkinleştirmek için etiketleri kullanmak tam bir örnek sağlar.

En iyi yöntemlere bakın.

Üç fiyatlandırma katmanı vardır: Ücretsiz, Standart ve Premium. Ayrıntılı fiyatlandırma bilgileri için Uygulama Yapılandırması fiyatlandırma sayfasına bakın.

Tüm Uygulama Yapılandırması katmanları yapılandırma ayarları, özellik bayrakları, Key Vault başvuruları, yapılandırma anlık görüntüleri, temel yönetim işlemleri, ölçümler ve günlükler gibi temel işlevleri sunar.

Aşağıda katman seçmeyle ilgili dikkat edilmesi gerekenler yer alır.

• Amaç: Ücretsiz katmanı, üretim dışı ortamlarda hizmeti değerlendirmek için mükemmeldir ve bu sayede özelliklerini ücretsiz olarak keşfedebilirsiniz. Standart katman, orta hacimli üretim kullanım örnekleri için uyarlanmıştır ve performans ve maliyet verimliliği dengesi sağlar. Yüksek hacimli veya kurumsal düzeyde üretim ihtiyaçları için Premium katmanı en yüksek performans ve ölçeklenebilirlik düzeyini sunar ve uygulamalarınızın ağır yük altında bile sorunsuz çalışmasını sağlar.

• Abonelik başına kaynaklar: Kaynak tek bir yapılandırma deposundan oluşur. Her abonelik, Ücretsiz katmanında bölge başına bir yapılandırma deposuyla sınırlıdır. Aboneliklerin Standart ve Premium katmanlarında sınırsız sayıda yapılandırma deposu olabilir.

• Kaynak başına depolama: Ücretsiz katmanında her yapılandırma deposu 10 MB normal depolama alanı ve 10 MB anlık görüntü depolama alanı ile sınırlıdır. Standart katmanda her yapılandırma deposu 1 GB'a kadar normal depolama alanı ve ek 1 GB anlık görüntü depolama alanı kullanabilir. Premium katmanında her yapılandırma deposu 4 GB'a kadar normal depolama alanı ve ek 4 GB anlık görüntü depolama alanı kullanabilir.

• Düzeltme geçmişi: Uygulama Yapılandırması anahtarlarda yapılan tüm değişikliklerin geçmişini depolar. Ücretsiz katmanında bu geçmiş yedi gün boyunca depolanır. Standart ve Premium katmanlarında bu geçmiş 30 gün boyunca depolanır.

• İstek kotası: Ücretsiz katman depoları günde 1.000 istekle sınırlıdır. Bir mağaza 1.000 isteğe ulaştığında, UTC gece yarısına kadar tüm istekler için 429 HTTP durum kodunu döndürür.

  Standart katman depoları saatte 30.000 istekle sınırlıdır. Saatlik kota tükendikten sonra, ek istekler saatin sonuna kadar çok fazla istek olduğunu belirten 429 HTTP durum kodu döndürebilir. Kotanın üzerinde olan daha fazla istek gönderildikçe, bunların daha yüksek bir yüzdesi durum kodu 429 döndürebilir.

  Premium katman depolarının isteklerde kota sınırı yoktur ve mağazaya erişimin hiçbir zaman engellenmemesini sağlar.

• Aktarım hızı: tüm katmanlardaki Uygulama Yapılandırması depoların aktarım hızı izni vardır. Bu izni aşan istekler bir HTTP durum kodu 429 yanıtı alır. Ücretsiz katmanındaki depolar garantili aktarım hızına sahip değildir.

  Standart katmandaki depolar çalıştırma hızına izin verir† okuma istekleri için saniyede en fazla 300 istek (RPS) ve yazma istekleri için 60 RPS'ye kadar.

  Premium katmanındaki depolar çalıştırma hızına izin verir† okuma istekleri için en fazla 450 RPS ve yazma istekleri için 100 RPS'ye kadar.

  †Çalıştırma hızı genellikle belirli bir süre boyunca azaltma olmadan bir Uygulama Yapılandırması deposu tarafından işlenen ortalama istek sayısı olarak ölçülür.

• Hizmet düzeyi sözleşmesi: Ücretsiz katmanın SLA'sı yoktur. Standart katmanın SLA'sı %99,9 kullanılabilirliğe ve coğrafi çoğaltma etkinken %99,95 kullanılabilirliğe sahiptir. Premium katmanında %99,9 kullanılabilirlik ve coğrafi çoğaltma etkinleştirildiğinde %99,99 kullanılabilirlik SLA'sı vardır.

• Özellikler: Tüm katmanlar Microsoft tarafından yönetilen anahtarlarla şifreleme, erişim anahtarı veya Microsoft Entra Kimliği aracılığıyla kimlik doğrulaması, Azure rol tabanlı erişim denetimi (RBAC), yönetilen kimlik, hizmet etiketleri ve kullanılabilirlik alanı yedekliliği gibi işlevleri içerir. Standart ve Premium katmanları, Özel Bağlantı desteği, müşteri tarafından yönetilen anahtarlarla şifreleme, geçici silme koruması ve coğrafi çoğaltma özelliği gibi daha fazla işlev sunar.

• Maliyet: Ücretsiz katman mağazasını kullanmanın bir maliyeti yoktur.

  Standart katman mağazalarının günlük kullanım ücreti vardır ve bu ücret her gün ilk 200.000 isteği içerir. Bu günlük ayırmanın ötesindeki istekler fazla kullanım ücretine neden olabilir.

  Premium katman mağazalarının günlük kullanım ücreti de vardır ve bir çoğaltma içerir. Kaynak için ilk 800.000 istek ve her gün çoğaltma için ilk 800.000 istek günlük ücrete eklenir. Bu günlük ayırmayı aşan istekler fazla kullanım ücretine neden olabilir.

İstediğiniz zaman bir Uygulama Yapılandırması depoyu yükseltebilirsiniz; örneğin, Ücretsiz katmanından Standart veya Premium katmanına veya Standart katmanından Premium katmanına.

Premium katmanından Standart katmana veya Standart katmandan Ücretsiz katmanına Uygulama Yapılandırması bir depoyu düşüremezsiniz. Ancak, istediğiniz katmanda yeni bir depo oluşturabilir ve ardından yapılandırma verilerini bu depoya aktarabilirsiniz.

Uygulama Yapılandırması'de depolanan müşteri verileri, müşterinin Uygulama Yapılandırması deposunun oluşturulduğu bölgede yer alır. Müşteri verileri, yalnızca müşteri bu bölge için coğrafi çoğaltmayı etkinleştirirse başka bir bölgeye çoğaltılır . Bu, kullanılabilir tüm bölgeler için geçerlidir. Müşteriler verileri küresel olarak herhangi bir konumdan taşıyabilir, kopyalayabilir veya bu verilere erişebilir.

Azure Uygulaması Yapılandırması, bölgesel kesintilere karşı gelişmiş dayanıklılık için coğrafi çoğaltmayı destekler.

Azure Uygulaması Yapılandırması, uygulamanızı ve verilerinizi tek veri merkezi hatalarına karşı korumak için Azure kullanılabilirlik alanlarını destekler. Kullanılabilirlik alanının etkinleştirildiği tüm bölgeler, her birinin fiziksel olarak bağımsız bir veri merkezi olduğu en az üç kullanılabilirlik bölgesinden oluşur. Dayanıklılık için, Uygulama Yapılandırması'deki bu destek ek ücret ödemeden tüm müşteriler için etkinleştirilir. Aşağıda, kullanılabilirlik alanı desteğini etkinleştirmiş Uygulama Yapılandırması bölgeler yer alır. Daha fazla bilgi için bkz. Azure'da bölgeler ve Kullanılabilirlik Alanları.

Aşağıda, Uygulama Yapılandırması kullanılabilirlik alanı desteğini etkinleştirdiği bölgeler yer alır.

Uygulama Yapılandırması mağazaların katmanlarına göre farklı istek kotaları vardır. Ücretsiz katman mağazaları günde 1.000 istekle sınırlıdır, Standart katman depoları saatte 30.000 istekle sınırlıdır ve Premium katman mağazalarının istek sınırı yoktur ve kesintisiz erişim sağlanır.

Uygulama Yapılandırması depoları, katmanlarına göre aktarım hızı izinlerine sahiptir. Ücretsiz katman depolarının aktarım hızı garantili değildir. Standart katman depoları, okuma işlemleri için saniyede 300 istek (RPS) ve yazma işlemleri için 60 RPS'ye kadar çalıştırma hızını destekler. Premium katman depoları, okuma işlemleri için 450 RPS'ye ve yazma işlemleri için 100 RPS'ye kadar çalıştırma hızını destekler.

Bir örnek alalım ve 1.000 yapılandırma ayarına sahip bir uygulamanız olduğunu varsayalım. Uygulamanız başlangıçta Uygulama Yapılandırması tüm bu ayarları yükler. Bundan sonra, her 30 saniyede bir yapılandırma değişiklikleri için bir sentinel anahtarı denetler. Kubernetes, App Service veya VM'lerde çalışıyor olun, uygulamanızın 50 örneğinin aynı anda çalıştığını varsayalım.

İlk olarak, yapılandırma izleme isteklerini tahmin edelim. Uygulamanızın her örneği sentinel anahtarı için her 30 saniyede bir Uygulama Yapılandırması için bir istek gönderir, bu nedenle bir saat içinde 120 (=3600/30) istek gönderir. Uygulamanızın 50 örneği olduğu düşünüldüğünde, uygulamanız yapılandırma izleme için saatte bir 6.000 (=120x50) toplam istek gönderir. Sentinel anahtar istekleri sık olduğundan ve çoğunlukla değişmediğinden, çoğu Standart katman deposu için mağaza saatlik kota sınırlarına† karşı sayılmaz.

İkinci olarak, yapılandırma yükleme/yeniden yükleme isteklerini tahmin edelim. Uygulamanız başlangıçta veya bir sentinel anahtarı değişikliği algılandığında tüm ayarları yükler. Uygulama Yapılandırması her istek en fazla 100 anahtar değeri alabilir, bu nedenle tüm ayarları yüklemek için 10 (=1000/100) istek gerekir. 50 uygulama örneğiniz olduğu düşünüldüğünde, uygulamanız yapılandırmasını yeniden başlattığınızda veya yeniden yüklediğinde toplam 500 (=10x50) istek gönderirsiniz.

Son olarak, bir araya getirelim. Sentinel anahtarını bir saat içinde iki kez güncelleştirdiğiniz varsayıldığında, Uygulama Yapılandırması mağazanız bu saat için toplam 7.000 (=6.000+500x2) istek alır. Bu isteklerden yalnızca yaklaşık 1.000 (=500x2) isteğin Standart katman deposu için kullanılabilir saatlik kotayı kullandığını unutmayın. Saatlik kota sınırına karşı yeterli bir arabelleğe sahip olmak için bu örnekteki sayıları kendi kurulum ve tasarımınızla eşleşecek şekilde güncelleştirin.

†Free katman depolarında günlük sınırları dışında tutulan sık ve yinelenen istekler yoktur.

Uygulamanız aşağıdaki koşullarda bir HTTP durum kodu 429 yanıtı alabilir:

• Ücretsiz katmanındaki bir mağaza için günlük istek kotasını aşma.
• Standart katmandaki bir mağaza için saatlik istek kotasını aşma.
• Herhangi bir katmandaki bir depo için aktarım hızı iznini aşma.
• Herhangi bir katmandaki bir mağaza için bant genişliği iznini aşma.
• Depolama kotası aşıldığında anahtar-değer oluşturmaya veya değiştirmeye çalışma.

İsteğin başarısız olmasının belirli bir nedeni için 429 yanıtının gövdesini denetleyin. Ayrıca Azure İzleyici'de Uygulama Yapılandırması deponuz için günlükleri toplayabilir ve İstek KotaSı Kullanımı ölçümü için uyarılar ayarlayabilirsiniz.

Anlık HTTP durum kodu 429 yanıtlarının alınması genellikle hiçbir zarara neden olmaz çünkü Uygulama Yapılandırması istemciler bunları düzgün bir şekilde işler. Ancak uygulamanız düzenli olarak HTTP durum kodu 429 yanıtlarıyla karşılaşıyorsa aşağıdaki seçenekleri göz önünde bulundurun:

• Deponuzu Premium katmanına yükseltin: Bu katmanın isteklerde kota sınırı yoktur ve depolama kotası ve daha yüksek aktarım hızı izni artmıştır.
• Uygulama Yapılandırması Sağlayıcılarını kullanma: Sağlayıcılar, diğer birçok dayanıklılık özelliğinin yanı sıra yerleşik yeniden deneme ve önbelleğe alma özelliklerine sahiptir. En son geliştirmeler için sağlayıcının en son sürümüne güncelleştirin.
• Uygulamanızın yazma istekleri göndermesi gerekiyorsa Uygulama Yapılandırması SDK'ları kullanın. SDK'lar sağlayıcılar kadar özellik açısından zengin olmasa da, HTTP durum kodu 429 yanıtlarını ve diğer geçici hataları otomatik olarak yeniden dener.
• Uygulama Yapılandırması Sağlayıcıları veya SDK'ları kullanamıyorsanız özel istemcilere yeniden deneme mantığı ekleyin. Yanıttaki retry-after-ms üst bilgi, isteği yeniden denemeden önce önerilen bir bekleme süresi (milisaniye) sağlar.
• İstekleri birden çok istemci örneğine dağıtın: Bu, Uygulama Yapılandırması deponuzdan maksimum aktarım hızına ulaşmanıza yardımcı olur.
• Uygulama Yapılandırması yapılan istekleri azaltma: İstek sayısını en aza indirmek için yönergeleri izleyin.
• Uygulama dayanıklılığınızı geliştirin: Yük devretme ve yük dengelemeye izin vermek için coğrafi çoğaltmayı tümleştirmeyi göz önünde bulundurun. Yüksek oranda dayanıklı uygulamalar oluşturmak için en iyi yöntemleri gözden geçirin.

Standart ve Premium katmanlarındaki tüm Uygulama Yapılandırması depoları geçici silme özelliğini otomatik olarak etkinleştirdi. Bir Standart veya Premium katmanı Uygulama Yapılandırması deposu silindiğinde, bu katmanın adı saklama süresi için ayrılır. Saklama süresi dolmadan önce aynı ada sahip bir depoyu yeniden oluşturmak için , mağazada temizleme koruması etkinleştirilmemişse önce geçici olarak silinen depoyu temizlemeniz gerekir. Temizleme koruması etkinse saklama süresinin geçmesini beklemeniz gerekir. Aynı ada sahip bir mağazayı yeniden oluşturmanız gerekirse temizleme işlevini kullanın veya daha kısa bir saklama süresi ayarlayın. Aynı ada sahip bir deponun yeniden oluşturulmasını gerektiren iş akışları, yapılandırma depolarını temizleme ve sonraki oluşturma işlemini gerçekleştirme arasında bir saat izin vermelidir. Temizleme istendikten sonra yapılandırma deposu kaynaklarının gerçek temizliği zaman uyumsuz olarak gerçekleştirildiğinden ve sonlandırmak için biraz ek süre gerektirdiğinden bu öneri uygulanır. Bekleme gereksinimini önlemek için kısa ömürlü yapılandırma depoları oluşturan iş akışlarının benzersiz adlar kullanması önerilir.

Standart ve Premium katmanlarındaki tüm Uygulama Yapılandırması depoları geçici silme özelliğini destekler ve bu özellik devre dışı bırakılamaz. Silinen depoları saklama süresi içinde kurtarabilirsiniz. Yanlışlıkla silinen Uygulama Yapılandırması depolarını kurtarmak için bu yönergeleri izleyin.

Evet. Azure portalı veya CLI aracılığıyla Uygulama Yapılandırması'de özellik bayraklarını ve Key Vault başvurularını yönetebilirsiniz ancak Uygulama Yapılandırması SDK'ları kullanarak bunları program aracılığıyla da oluşturabilir ve güncelleştirebilirsiniz. Bu nedenle, özelleştirilmiş yönetim portalınızı yazabilir veya bunları program aracılığıyla CI/CD'nizde yönetebilirsiniz. Özellik bayrağı ve Key Vault başvuru API'leri desteklenen tüm dillerin SDK'larında kullanılabilir. Desteklenen her dildeki örnekler için örnek bağlantılara göz atın.

Uygulamanızda özellik bayraklarının değerlendirilmesi ve tüketilmesi için .NET ve Java Spring'de kullanılabilen Uygulama Yapılandırması sağlayıcısı ve özellik yönetimi kitaplıkları gerekir. Daha fazla bilgi için Hızlı Başlangıçlar ve Öğreticiler altındaki Özellik yönetimi bölümüne göz atın.

Spring profilleri, yapılandırma dahil olmak üzere uygulamanızın bölümlerini ayırmak ve yalnızca belirli ortamlarda veya belirli kitaplıklar kullanıldığında kullanılabilir hale getirmek için bir yol sağlar.

Anahtar-değerlerinizin etiketini Spring profillerinizle eşleşecek şekilde ayarlamanız önerilir. Varsayılan olarak, Uygulama Yapılandırması Spring sağlayıcı kitaplığı, etiket filtresi açıkça ayarlanmadıysa geçerli etkin Spring profilleriyle (${spring.profiles.active}) eşleşen etiketlerle anahtar değerlerini yükler. Etkin Spring profil kümesi yoksa, "etiketsiz" anahtar değerleri yüklenir.

Örneğin, profiller dev ve prodile aşağıdaki etiketlere göre anahtar-değerler oluşturursunuz.

Spring profili olarak devayarlandığında değeri config.message olur Hello from dev. Spring profili olarak prodayarlandığında değeri config.message olur Hello from prod.

Bu varsayılan davranış, bootstrap dosyanızda etiket filtresi ayarlanarak geçersiz kılınabilir. Spring sağlayıcı kitaplığı, etkin Spring profilinden bağımsız olarak belirtilen etiketlere sahip anahtar değerlerini yükler.

spring.cloud.azure.appconfiguration.stores[0].selects[0].label-filter: my-label

Diğer etiketleri ve Spring profillerinizi seçmek için, etiketi olmayan tüm anahtarları ve Spring profillerinizle eşleşenleri seçen gibi ',${spring.profiles.active}'bir etiket filtresi kullanabilirsiniz. Yinelenen anahtarlar bulunduğunda en sağdaki etiketler öncelik alır.

Sürüm 3.1.0'dan başlayarak kitaplık, Microsoft.FeatureManagement bağımlılık ekleme tabanlı .NET uygulamalarında kapsamlı hizmetler olarak özellik filtreleri de dahil olmak üzere özellik yönetim hizmetlerinin çalıştırılmasına olanak tanır. Bu özelliğin avantajlarından yararlanmak için, aşağıdaki kod parçacığında gösterildiği gibi kodunuzdaki çağrıyı ile AddScopedFeatureManagementdeğiştirmeniz AddFeatureManagement yeterlidir:

services.AddScopedFeatureManagement();

Özellik filtreleri, http isteğinin özelliklerine göre bir özellik bayrağını değerlendirebilir. Bu genellikle tekil IHttpContextAccessor desen üzerinden incelenerek HttpContext gerçekleştirilir. Ancak bu düzen, kapsamlı hizmetlerin kullanılması gereken Blazor sunucu uygulamalarında çalışmaz. Bu durumda yöntemi AddScopedFeatureManagement kullanılmalıdır.

GitHub duyuruları depomuza abone olun.

Doğrudan GitHub'dan bize ulaşabilirsiniz.

• Azure Uygulaması Yapılandırması Hakkında