Azure Uygulama Yapılandırması özellik bayrakları aracılığıyla özellik yönetimi sağlayarak ekiplerin kodu yeniden dağıtmadan uygulama işlevselliğini dinamik olarak denetlemesini sağlar. Bu sayede güvenli, hedefli dağıtımlar, daha hızlı denemeler ve azaltılmış risk sayesinde geliştiricilere uygulama davranışı üzerinde esnek denetim ve değişen iş veya müşteri gereksinimlerine hızlı yanıt verebilme olanağı sağlanır.
Azure portalındaki özellik yöneticisi, uygulamalarınızda kullandığınız özellik bayraklarını oluşturmaya ve yönetmeye yönelik bir kullanıcı arabirimi sağlar.
Önkoşullar
Özellik bayrağı oluşturma
Aşağıdaki adımları izleyerek Azure portalında yeni bir özellik bayrağı oluşturun.
Azure portalında Azure Uygulama Yapılandırma deponuzu açın. Kaynak menüsündeki İşlemler'in altında Özellik yöneticisi>Oluştur'u seçin.
Özellik bayrağınızı ne için kullanacaksınız? bölümünde aşağıdaki amaçlardan birini seçin:
-
Anahtar – Özellikleri basit bir anahtarla açma/kapatma. Tek bir açma/kapatma denetiminin yeterli olduğu kısa süreli operasyonel geçişler ve senaryolar için kullanın.
-
Dağıtım : Kullanıcıların yüzdesi için özelliği aşamalı olarak etkinleştirin. Riski azaltmak için aşamalı özellik sürümleri ve ortamlar veya kullanıcı segmentleri arasında kanarya veya aşamalı dağıtımlar için kullanın.
-
Deneme : En iyi performansa sahip değişkeni belirlemek için trafik ayırma ile denetimli denemeler çalıştırın. A/B testi, çok değişkenli denemeler veya ölçüm temelli özellik değerlendirmesi ve istatistiksel karşılaştırma gerektiren diğer senaryolar için kullanın.
İşlevselliği tüm kullanıcılar için anında etkinleştirmek veya devre dışı bırakmak için Anahtar'ı kullanın.
Özellik bayrağınızın temel özelliklerini ayarlamak için Temel bilgiler'i yapılandırın.
| Ayar |
Örnek değer |
Açıklama |
|
Özellik bayrağını etkinleştir |
Aç/kapat |
Bu seçenek, oluşturma sırasında özellik bayrağını etkinleştirir. Bunu kapatırsanız, yeni özellik bayrağının yapılandırması kaydedilir ancak yeni özellik bayrağı devre dışı kalır. |
|
Özellik anahtarı adı |
Beta |
Özellik bayrağı adı, kodunuzda bayrağa başvurmak için kullandığınız addır. Bir uygulama içinde benzersiz olmalıdır. |
|
Anahtar |
Beta |
Uygulamanıza yüklenen özellik bayraklarını filtrelemek için anahtarını kullanabilirsiniz. Anahtar varsayılan olarak özellik bayrağı adından oluşturulur, ancak özellik bayraklarınızı gruplandırmak için bir önek veya ad alanı da ekleyebilirsiniz; örneğin, .appconfig.featureflag/Beta. |
|
Etiket |
Boş bırakın |
Etiketleri kullanarak aynı anahtar için farklı özellik bayrakları oluşturabilir ve etikete göre uygulamanıza yüklenen filtre bayraklarını kullanabilirsiniz. Varsayılan olarak, özellik bayrağının etiketi yoktur. |
|
Açıklama |
Boş bırakın |
Özellik bayrağınız için boş bırakın veya bir açıklama girin. |
Telemetriyi bu özellik bayrağı için değerlendirme olaylarını toplayacak şekilde yapılandırın. Etkinleştirildiğinde, değerlendirme olayları uygulamanızda yapılandırdığınız telemetri yayımcısına gönderilir. Telemetriyi etkinleştirmeden önce bir Application Insights kaynağını TelemetriApp Insights'taki Uygulama Yapılandırma > bağlayın.
Yeni özellik bayrağınızın özetini görmek için Gözden geçir + oluştur'u ve ardından işleminizi sonlandırmak için Oluştur'u seçin. Bildirim, yeni özellik bayrağının başarıyla oluşturulduğunu gösterir.
Bir özelliği kullanıcıların bir yüzdesine aşamalı olarak göstermek için Dağıtımı kullanın.
Özellik bayrağınızın temel özelliklerini ayarlamak için Temel bilgiler'i yapılandırın.
| Ayar |
Örnek değer |
Açıklama |
|
Özellik bayrağını etkinleştir |
Aç/kapat |
Bu seçenek, oluşturma sırasında özellik bayrağını etkinleştirir. Bunu kapatırsanız, yeni özellik bayrağının yapılandırması kaydedilir ancak yeni özellik bayrağı devre dışı kalır. |
|
Özellik anahtarı adı |
Beta |
Özellik bayrağı adı, kodunuzda bayrağa başvurmak için kullandığınız addır. Bir uygulama içinde benzersiz olmalıdır. |
|
Anahtar |
Beta |
Uygulamanıza yüklenen özellik bayraklarını filtrelemek için anahtarını kullanabilirsiniz. Anahtar varsayılan olarak özellik bayrağı adından oluşturulur, ancak özellik bayraklarınızı gruplandırmak için bir önek veya ad alanı da ekleyebilirsiniz; örneğin, .appconfig.featureflag/myapp/Beta. |
|
Etiket |
Boş bırakın |
Etiketleri kullanarak aynı anahtar için farklı özellik bayrakları oluşturabilir ve etikete göre uygulamanıza yüklenen filtre bayraklarını kullanabilirsiniz. Varsayılan olarak, özellik bayrağının etiketi yoktur. |
|
Açıklama |
Boş bırakın |
Özellik bayrağınız için boş bırakın veya bir açıklama girin. |
İzleyici sekmesinde, belirli bir yüzde için özellik bayrağını açın veya grupları ve kullanıcıları açıkça dahil edin veya hariç tutun.
| Ayar |
Örnek değer |
Açıklama |
|
Varsayılan Yüzde |
0–100 |
Özelliği varsayılan olarak alan kullanıcıların yüzdesini belirtmek için 0 ile 100 arasında bir değer girin. |
|
Gruplara Göre Geçersiz Kıl |
Kapalı (seçili değil) |
Grup tabanlı geçersiz kılmaları etkinleştirmek için seçin. Etkinleştirildiğinde şunları yapabilirsiniz: - Dağıtıma açıkça eklenecek grupları ekleyin ve özelliği alması gereken grup üyelerinin yüzdesini ayarlayın.
- Dağıtımın dışında tutulacak grupları ekleyin.
|
|
Kullanıcılar Tarafından Geçersiz Kılma |
Kapalı (seçili değil) |
Kullanıcı tabanlı hedeflemeyi etkinleştirmek için seçin. Etkinleştirildiğinde, dahil etmek veya dışlamak için tek tek kullanıcıları belirtebilirsiniz. |
Yapılandırma sekmesinde, özellik bayrağınızın değerlerini yapılandırın. Uygulamanız, her kullanıcı için hangi değerin geçerli olduğunu değerlendirerek uygun yapılandırmayı alabilir.
| Ayar |
Örnek değer |
Açıklama |
|
Yapılandırmayı dahil et |
Kutu işaretli |
Özellik bayrağına anahtar-değer ayarları eklemek için seçin. Bu ayarlar, uygulamanızın kodu yeniden dağıtmadan davranışı dinamik olarak ayarlamasına olanak sağlar. |
|
Eski Yapılandırma |
{"color":"blue"} |
Bu güncelleştirmeden önce özellik bayrağıyla ilişkilendirilmiş yapılandırma değerlerini gösterir. Değişiklikleri karşılaştırmak ve sürümleri izlemek için bunu kullanın. |
|
Yeni Yapılandırma |
{"color":"green"} |
Şimdi uyguladığınız güncelleştirilmiş yapılandırma değerlerini gösterir. Bu değerler eski yapılandırmayı geçersiz kılar ve özellik bayrağı etkinleştirildiğinde yeni davranışı tanımlar. |
Değişiklikleri zamanlamak ve özelliklerinize hizmet vermek için özel kısıtlamaları yönetmek için Koşulları yapılandırın.
| Ayar |
Örnek değer |
Açıklama |
|
Zamanlama ekleme |
Başlangıç: 2025-11-01 Bitiş: 2025-11-15 Saat dilimi: (UTC-06:00) Merkezi Saat (ABD ve Kanada) Yinelenme: devre dışı |
Başlangıç ve bitiş tarihlerini belirterek zamana dayalı bir dağıtım tanımlayın. İsteğe bağlı olarak önerilen saat dilimini güncelleştirin ve yinelenen etkinleştirmeler için yinelenmeyi etkinleştirin. |
|
Özel koşul ekleme |
User.Subscription == "Premium" |
Özel öznitelikleri (örneğin, bölge, cihaz türü veya abonelik düzeyi) temel alan koşullar oluşturun. Koşullar, özelliği tam olarak hangi kullanıcıların alacağını hedeflemenizi sağlar. |
|
Tüm özellik filtrelerinin etkinleştirilmesini gerektir |
Açık (seçili) |
Bu seçenek yalnızca Özel koşul ekle ve Zamanlama ekle'yi etkinleştirdikten sonra görünür. İşaretlendiğinde, özelliğin uygulanması için tüm etkin özellik filtreleri doğru olarak değerlendirilmelidir (mantıksal VE). İşareti kaldırıldığında filtreler bağımsız olarak değerlendirilir (mantıksal VEYA). |
Telemetriyi bu özellik bayrağı için değerlendirme olaylarını toplayacak şekilde yapılandırın. Etkinleştirildiğinde, değerlendirme olayları uygulamanızda yapılandırdığınız telemetri yayımcısına gönderilir. Telemetriyi etkinleştirmeden önce bir Application Insights kaynağını TelemetriApp Insights'taki Uygulama Yapılandırma > bağlayın.
Yeni özellik bayrağınızın özetini görmek için Gözden geçir + oluştur'u ve ardından işleminizi sonlandırmak için Oluştur'u seçin. Bildirim, yeni özellik bayrağının başarıyla oluşturulduğunu gösterir.
A/B testleri çalıştırmak ve varyantları karşılaştırmak için Deneme'yi kullanın.
Özellik bayrağınızın temel özelliklerini ayarlamak için Temel bilgiler'i yapılandırın.
| Ayar |
Örnek değer |
Açıklama |
|
Özellik bayrağını etkinleştir |
Aç/kapat |
Bu seçenek, oluşturma sırasında özellik bayrağını etkinleştirir. Bunu kapatırsanız, yeni özellik bayrağının yapılandırması kaydedilir ancak yeni özellik bayrağı devre dışı kalır. |
|
Özellik anahtarı adı |
Beta |
Özellik bayrağı adı, kodunuzda bayrağa başvurmak için kullandığınız addır. Bir uygulama içinde benzersiz olmalıdır. |
|
Anahtar |
Beta |
Uygulamanıza yüklenen özellik bayraklarını filtrelemek için anahtarını kullanabilirsiniz. Anahtar varsayılan olarak özellik bayrağı adından oluşturulur, ancak özellik bayraklarınızı gruplandırmak için bir önek veya ad alanı da ekleyebilirsiniz; örneğin, .appconfig.featureflag/myapp/Beta. |
|
Etiket |
Boş bırakın |
Etiketleri kullanarak aynı anahtar için farklı özellik bayrakları oluşturabilir ve etikete göre uygulamanıza yüklenen filtre bayraklarını kullanabilirsiniz. Varsayılan olarak, özellik bayrağının etiketi yoktur. |
|
Açıklama |
Boş bırakın |
Özellik bayrağınız için boş bırakın veya bir açıklama girin. |
Davranışı karşılaştırmak, trafiği ayırmak ve hedeflenen testleri çalıştırmak için Varyantları yapılandırın.
| Ayar |
Örnek değer |
Açıklama |
|
Değişken adı |
Değişken 1 |
Her değişken için benzersiz bir ad girin. |
|
Değer |
<varyantınız-1-değeri> |
Değişken için döndürülen değer. Dize, sayı, boole veya JSON nesnesi olabilir. Uygulamanızın bayrağı değerlendirirken okuduğu karmaşık JSON yapılandırması için Çok satırlı Düzenleme değerini kullanın. |
|
Varsayılan değişken |
Değişken 1 (Varsayılan) |
Kararlı geri dönüş ve taban çizgisi olarak bir değişken seçin. Bu değişken, belirli bir atama uygulanmadığında veya özellik bayrağı devre dışı bırakıldığında döndürülür; aynı zamanda hedeflenen ayırma ve denetimli testler için kullanılan temeldir. |
Trafiği farklı değişkenler arasında dağıtmak ve belirli gruplar veya kullanıcılar için geçersiz kılmalar uygulamak için Ayırma'yı yapılandırın.
| Ayar |
Örnek değer |
Açıklama |
|
Çeşitlemeler arasında trafik dağıtımı |
Varsayılan: 100% Değişken 1: 0% Değişken 2: 0% |
Her değişkene ayrılan trafiğin yüzdesini belirtin. Tüm varyantların dağılımı toplamda %100'e ulaşmalıdır. Hedef kitlenin farklı çeşitlemelere nasıl maruz olduğunu denetlemek için bunu kullanın. |
|
Tahsis geçersiz kılmaları |
Gruplara Göre Aşma / Kullanıcılara Göre Aşma |
Yüzde tabanlı ayırmadan bağımsız olarak belirli gruplara veya tek tek kullanıcılara belirli çeşitlemeler atayın. Hem grup hem de kullanıcı geçersiz kılmaları uygulandığında, kullanıcı ataması öncelik taşır. |
|
Dağıtım (çekirdek) |
Özel tohum kullan: 12345 |
Varsayılan olarak yüzdebirlik dağılımı rastgeledir. Aynı çekirdek değerini paylaşan özellik bayrakları arasında belirlenimci (yinelenebilir) ayırmalar oluşturmak için sabit bir çekirdek sağlayın. |
Önemli
Özellik değerlendirmeleri bir istemci uygulamasında (örneğin, bir web tarayıcısı) gerçekleşirse, özellik bayrağı verileri (burada belirtilen kullanıcı adları dahil) son kullanıcılara gösterilebilir. Daha fazla bilgi için bkz. Uygulama Yapılandırması'nda istemci uygulamaları.
Özelliklerinizi kullanıma sunmayla ilgili açıklığı sınırlamak, değişiklikleri zamanlamak ve özel kısıtlamaları yönetmek için Koşulları yapılandırın.
| Ayar |
Örnek değer |
Açıklama |
|
Pozlamayı sınırla |
Kutu işaretli |
Seçildiğinde, yüzdeye, gruplara ve kullanıcılara göre pozlamayı denetlemek için ek seçenekler görünür. İşaretlenmemişse, özellik bayrağı bu kısıtlamalar olmadan genel olarak uygulanır. |
|
Varsayılan Yüzde |
100 |
Yalnızca Pozlamayı sınırla işaretlendiğinde görünür. Özelliği varsayılan olarak alan tüm kullanıcı tabanının yüzdesini belirtmek için 0 ile 100 arasında bir değer girin. |
|
Gruplara Göre Geçersiz Kıl |
Dahil et: MarketingTeam (100%) Dışla: TestGroup |
Yalnızca Pozlamayı sınırla işaretlendiğinde görünür. Varsayılan yüzdenin dışında olsalar bile özelliği etkinleştirecek grupları dahil edin. Özelliği devre dışı bırakmak için grupları dışlayın. |
|
Kullanıcılar Tarafından Geçersiz Kılma |
Dahil Et: john@example.com Hariç tut: jane@example.com |
Yalnızca Pozlamayı sınırla işaretlendiğinde görünür. Varsayılan yüzdelik dilimin dışında olsalar bile özelliği etkinleştirmek amacıyla kullanıcıları ekleyin. Bu özelliği devre dışı bırakmak için kullanıcıları dışlama. Uzun bir kullanıcı listesi için özellik bayraklarının 10 kb sınırı olduğundan kullanıcılar yerine grupları kullanmanızı öneririz. |
|
Zamanlama ekleme |
Başlangıç: 2025-11-01 Bitiş: 2025-11-15 Saat dilimi: (UTC-06:00) Merkezi Saat (ABD ve Kanada) Yinelenme: Haftalık |
Başlangıç ve bitiş saatlerini belirterek zamana dayalı bir dağıtım tanımlayın. İsteğe bağlı olarak önerilen saat dilimini güncelleştirin ve yinelenen etkinleştirmeler için yinelenmeyi etkinleştirin (örneğin, haftalık veya aylık). |
|
Özel koşul ekleme |
User.Region == "EU" |
Özel öznitelikleri (örneğin, bölge, cihaz türü veya abonelik düzeyi) temel alan koşullar oluşturun. Koşullar, yalnızca bu ölçütlere uyan kullanıcıların özelliği alması için kesin hedeflemeye olanak tanır. |
|
Tüm özellik filtrelerinin etkinleştirilmesini gerektir |
Açık (seçili) |
Bu seçenek yalnızca birden çok koşulu etkinleştirdikten sonra görünür. İşaretlendiğinde, özellik bayrağının uygulanması için tüm etkin özellik filtreleri true olarak değerlendirilmelidir (mantıksal VE). İşareti kaldırıldığında filtreler bağımsız olarak değerlendirilir (mantıksal VEYA). |
Telemetriyi bu özellik bayrağı için değerlendirme olaylarını toplayacak şekilde yapılandırın. Etkinleştirildiğinde, değerlendirme olayları uygulamanızda yapılandırdığınız telemetri yayımcısına gönderilir. Telemetriyi etkinleştirmeden önce bir Application Insights kaynağını TelemetriApp Insights'taki Uygulama Yapılandırma > bağlayın.
Yeni özellik bayrağınızın özetini görmek için Gözden geçir + oluştur'u ve ardından işleminizi sonlandırmak için Oluştur'u seçin. Bildirim, yeni özellik bayrağının başarıyla oluşturulduğunu gösterir.
Özellik bayraklarını düzenleme
Özellik bayrağını güncelleştirmek için şu adımları izleyin:
Kaynak menüsünde İşlemler>Özellik Yöneticisi'ne gidin.
Değiştirmek istediğiniz özellik bayrağının sağ ucuna geçin ve Diğer eylemler üç noktasını (...) seçin. Bu menüden özellik bayrağı ayrıntılarını görüntüleyebilir, bayrağı düzenleyebilir, kilitleyebilir veya kilidini açabilir, etiket oluşturabilir, etiketleri güncelleştirebilir, geçmişi gözden geçirebilir veya bayrağı silebilirsiniz.
Görsel düzenleyicisini kullanarak değişiklik yapmak için Düzenle'yi veya bayrağın ham JSON'unu doğrudan değiştirmek için Gelişmiş Düzenleme'yi seçin.
İsteğe bağlı olarak Etkin geçiş düğmesini açarak veya kapatarak özellik bayrağının durumunu değiştirin.
Görünümü yönet
Özellik yöneticisi menüsünde Azure Uygulama Yapılandırması'nda depolanan özellik bayrakları görüntülenir. Görünümü yönet'i seçerek Azure portalında Özellik yöneticisi görünümünü değiştirebilirsiniz.
Ayarlar , Daha fazla yükle eylemi başına kaç özellik bayrağının yüklendiğini seçmenize olanak tanır.
Daha fazla yükle yalnızca 200'den fazla özellik bayrakları varsa görünür.
Sütunları Düzenle, sütun eklemenize veya kaldırmanıza ve sütun sırasını değiştirmenize olanak tanır.
Özellik yöneticisi ile oluşturulan özellik bayrakları normal anahtar değerleri olarak depolanır. Özel ön ek .appconfig.featureflag/ ve içerik türü application/vnd.microsoft.appconfig.ff+json;charset=utf-8ile tutulurlar.
Yapılandırma gezgininde özellik bayraklarının temel anahtar değerlerini görüntülemek için aşağıdaki adımları izleyin.
Kaynak menüsünde İşlemler>Yapılandırma gezgini'ni ve ardından Görünüm >Yönet'iseçin.
Yapılandırma gezgininde Özellik bayraklarını ekle'yi ve Uygula'yı seçin.
İlgili içerik
Azure Uygulaması Yapılandırması ile özellik bayraklarını kullanmaya başlamak için uygulamanızın diline veya platformuna özgü aşağıdaki hızlı başlangıçlara geçin.